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Preface 


This manual describes the CONTROL DATA? Network Operating System (NOS) Version 2. NOS 
controls the operation of CDC" CYBER 180 Computer Systems; CDC CYBER 170 Computer 
Systems; CDC CYBER 70 Computer Systems, Models 71, 72, 73, and 74; and CDC 6000 Computer 
Systems. 


Organization and Audience 

This manual is the first of four volumes in the NOS 2 Reference Set. Volume 1 shows you how to 
enter, run, and correct programs and how to create, retrieve, and maintain permanent files at an 
interactive terminal. Other topics covered include physical terminal connection and procedures for 
entering and leaving the system. It is written for the person who has had little or no experience 
using computer systems in general and NOS in particular. It it assumed that the user writing the 
programs is either familiar with a programming language or taking a programming class. 
Descriptions and examples use FORTRAN Version 5 and BASIC Version 3, but generally the 
information applies to other languages also. A glossary of terms is provided in appendix A. Use of 
this manual does not require familiarity with any other NOS manual, but for a general 
introduction, we recommend that you first read the NOS Version 2 System Overview . 

Volume 2 , Guide to System Usage , describes the general concepts of NOS and some of the utilities 
used with NOS. Topics included are job processing, file concepts, procedures, magnetic tape 
processing, modifying files, and loading files. This volume is a learning tool and does not contain 
comprehensive descriptions of all NOS commands. It is written for the applications or systems 
programmer who is unfamiliar with NOS. 

Volume 3, System Commands , describes the system commands that form the user interface with 
NOS. It is written for all NOS users. 

Volume 4 y Program Interface f describes the COMPASS program interface with NOS. Detailed 
descriptions of function processors and macros available to COMPASS user programs are 
included. It is written for the experienced COMPASS applications programmer or systems 
programmer. 

The reader of each volume should have a knowledge of the material contained in the preceding 
volumes. 


Conventions and Assumptions 

In this manual, entries you can make to the computer system are shown in blue. When you type an 
entry at a terminal, type the characters without pressing the shift key or any other key unless 
specifically instructed to do so. On most terminals, the letters you type will appear as lowercase 
letters. Therefore, in examples that show how your entries and the system’s responses might look 
at a terminal, your entries are shown in lowercase blue letters, and system responses are shown in 
uppercase black letters. 
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However, general instructions in the text which give entries that you will type are shown in both 
uppercase and lowercase blue letters to indicate required characters. You must type the uppercase 
letters and the punctuation exactly as shown; you replace the lowercase letters with characters you 
have chosen. For example, an entry shown in the text as 

SAVE,filename 

could be entered at a terminal as 
save,myfiLe 

The notation yy/mm/dd is used throughout this manual to indicate the current date, for example, 
84/01/06 means that the date is January 6, 1984. Similarly, the notation hh.mm.ss is used to indicate 
the current time, for example, 14.25.30 means that the time is 30 seconds after 2:25 p.m. 

The procedures described in this manual (such as entering the system and using the carriage return, 
the termination sequence, the interruption sequence, and the cancel line sequence) assume you have 
a standard ASCII terminal and are using a standard NOS system. If you are using any other kind of 
terminal or if your computer center has made modifications to the system, you may need additional 
or amended procedures. Appendix B contains some additional information on terminals. 


Submitting Comments 

The last page of this manual is a comment sheet. Use the comment sheet to suggest specific 
improvements for the manual and to report any errors. If the comment sheet has already been used, 
you can mail your comments to: 

Control Data Corporation 
Publications and Graphics Division 
ARH219 

4201 Lexington Avenue South 
St. Paul, MN 55126-6198 

If you have access to SOLVER, an on-line problem reporting facility, you can use it to submit 
comments about the manual. Use NS2 as the product identifier. 


Related Publications 

Following is a list of NOS manuals that you may be interested in. 

The NOS System Information Manual is an online manual that includes brief descriptions of all 
NOS and NOS product manuals. To view this manual, log in to NOS and enter the command 
EXPLAIN. The System Information Manual can be useful in determining which manuals are 
appropriate for your use. 
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Control Data manuals are available through Control Data sales offices or Control Data Literature 
Distribution Services, 308 North Dale Street, St. Paul, MN 55103. 


Control Data Publication __ 

BASIC Version 3 Reference Manual 
CDCNET Terminal Interface Usage Manual 
FORTRAN Version 5 Reference Manual 
NOS Full Screen Editor User's Guide 

NOS Version 2 Reference Set, Volume 2, Guide to System Usage 

NOS Version 2 Reference Set, Volume 3, System Commands 

NOS Version 2 Reference Set, Volume 4, Program Interface 

NOS Version 2 System Overview 

NOS Version 2 Screen Formatting Reference Manual 

Text Editor Version 1 Reference Manual 

XEDIT Version 3 Reference Manual 


Publication 

Number 

19983900 

60461530 

60481300 

60460420 

60459670 

60459680 

60459690 

60459270 

60460430 

60436100 

60455730 
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This manual shows you how to use a terminal to communicate with your computer system. 
Knowing this will help you do your work faster and more efficiently. The computer system you are 
going to use is extremely powerful, but it is easy to use. It understands a large set of instructions, 
but allows you to perform most operations with just a few instructions. 


How to Use This Manual 

Sections 2 and 3 explain how you connect a terminal to the system, how you tell the system that 
you are ready to use it, and then how to leave the system when you are done. If somebody such as 
your employer or instructor has already given you exact, specific instructions on what to do once 
the system responds to you, then you will only need to read these sections for background 
information. If you have any problems, refer to section 7. This section describes some common 
problems users have and suggests solutions. 

Sections 4, 5, and 6 show you how to enter a program, run it, and get the results back at your 
terminal. If the program doesn't work, these sections tell you how to correct and retry it. They also 
describe how you tell the system to save your program so you need not reenter it each time you use 
the terminal. We assume you are either taking a programming class or know a programming 
language already. This manual alone does not teach programming concepts or specific languages. 

In this manual, entries you can make to the computer system are shown in blue. When you type an 
entry at a terminal, type the characters without pressing the shift key or any other key unless 
specifically instructed to do so. On most terminals, the letters you type will appear as lowercase 
letters. Therefore, in examples that show how your entries and the system’s responses might look 
at a terminal, your entries are shown in lowercase blue letters, and system responses are shown in 
uppercase black letters. 

However, general instructions in the text which give entries that you will type are shown in both 
uppercase and lowercase blue letters to indicate required characters. You must type the uppercase 
letters and the punctuation exactly as shown; you replace the lowercase letters with characters you 
have chosen. For example, an entry shown in the text as 

SAVE,filename 

could be entered at a terminal as 
save,myfile 
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How to Use the System 

Each time you use the system, you: 

1. Connect your terminal to the system. 

Some terminals are wired so that they are always connected to the system. Other terminals you 
must connect to the system using telephone lines. The next section explains how you can tell 
the difference. 

2. Tell the system that you are ready to start. 

This is called logging in to the system. The system asks for specific information to identify you 
as an authorized user. All you need do is respond to its prompting. 

3. Do your work. 

4. Tell the system that you're done. 

This is called logging out of the system. Just type 
BYE 

Every person who uses the system, whether a beginner or an experienced programmer, follows 
these same steps. Section 2 describes step 1; section 3 describes steps 2 and 4. 

The best way to become comfortable with the system is to experiment with it. It's almost 
impossible for you to accidentally damage the system or someone else's work. Before you can start, 
however, you need some information. 

The following page, Information Specific to Your System and Terminal , lists the information you 
will need. You may want to fill in this sheet and keep all the information together. Before starting, 
however, you should either remove the page from the manual or make a copy for your own use. 
This is done to protect the information should you lose the manual or let others use it. 

NOTE 


Keeping this information in a safe, secure place prevents others from being able to access your 
programs and data. 


The first section on the information sheet is for terminal settings. They are discussed in section 2 
which explains how to set up your terminal. You can fill in this section later. 

Next is a section for computer system phone numbers. For terminals that you must connect to the 
system by phone, you need to know the telephone numbers used to reach your system. Your 
employer, instructor, or someone at your computer center can give you these numbers. There may 
be one or several. Sometimes your computer center will associate certain phone numbers with 
certain characteristics of a terminal, such as terminal line speeds (the speed at which the terminal 
prints characters). You can list the numbers (and associated line speeds, if any) on the information 
sheet. 
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INFORMATION SPECIFIC TO YOUR SYSTEM AND TERMINAL 


Terminal settings: 


Computer system phone numbers: 


Associated terminal line speeds: 


Family name (if required): — 

User name:_ 

Password:_ 

Personal ID (if required):- 

Special procedures for login: 


Interruption sequence:_ 

Termination sequence:_ 

Cancel line sequence:_ 

Computer center phone number: 




You must be able to tell the system who you are. Again, your employer, instructor, or computer 
center personnel can give you: 

• A family name (may not be required). 

• A user name. 

• A password. 

• A personal identification (a personal ID may not be required). 

The system asks you for some or all of this information when you log in. You can record these 
names on the information sheet. 

Finally, ask your employer, instructor, or computer center personnel if there are any special 
procedures for using your particular terminals or system. For example, it’s possible your system 
may actually consist of more than one physical computer. In this case, you’ll be asked to choose 
one while you are logging in. This is the sort of additional information you could be given. You 
may want to insert these procedures in this manual or to record them on the information sheet. 

The interruption sequence, termination sequence, and cancel line sequence are entries you may 
want to make while you’re using the system. We’ll talk more about them and show you what their 
usual values are later in this manual. 

Now, go to a terminal. You don’t need work ready yet. To start, you can connect the terminal, log 
in, and then log out. 

If possible, have an experienced person show you how to connect the terminal, log in, and log out. 
This process is easy once you’ve seen it done, but the process on your system may differ slightly 
from that described in the next two sections of this manual. Because there are many kinds of 
terminals available and many ways your system could be modified, we’ve had to make certain 
assumptions about the terminals and system features that we describe. If you follow along using 
the next two sections and the system doesn’t respond as expected, ask your computer center 
personnel for help. 

If you run into problems anytime you’re using a terminal, refer to section 7, What to Do When You 
Have Problems . 
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Many different kinds of terminals are available. Some communicate with you using a screen 
(somewhat like a television screen). Others type on paper (like a typewriter). But all terminals have 
a keyboard that you use to type instructions to the system. Every instruction that you type and the 
system’s response to that instruction appear either on the screen or the paper. 



Display Screen Terminal 


Printing Terminal 


Setting Up Your Terminal 

Before you can connect your terminal to the system, the terminal must be turned on and certain 
switches must be in the correct positions. The switches and their settings vary from terminal to 
terminal. If the terminal you're at has been used by other people working with the same system, 
the switches should be set correctly; don’t change them. Or, directions for setting the switches may 
be posted near the terminal. If you’re not sure what to do, ask someone to show you. You may want 
to record some of this information about your terminal on the information sheet in section 1. 

Remember that certain terminal line speeds may be associated with certain phone numbers. If 
applicable, set the line speed switch to a number that matches one of those associated with the 
phone numbers you were given. If you’re not sure of the speed you should use, set the switch to any 
position (usually 10 to 30 characters per second). The system may be able to detect automatically 
what line speed you are using. Now you’re ready to connect your terminal to the system. 
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Connecting Your Terminal 

Some terminals are wired so that they are automatically connected to the system when they're 
turned on. You may hear them called hardwired terminals. Other terminals are connected to the 
system using a telephone and telephone lines. If there is no telephone near the terminal you are 
using, you can assume it is a hardwired terminal. In this case, you can skip the rest of this section 
and go on to section 3. 

A terminal that requires a telephone uses either an acoustic coupler or a data set. 

An acoustic coupler has two rubber cups into which the phone receiver will fit. The coupler is 
either built into the terminal or is a separate device beside the terminal. If it is a separate device, 
turn it on. 




Separate Coupler 


On the front of a data set is either a switch labeled TALK and DATA or individual buttons labeled 
TALK and DATA. Most commonly, the data set is separate from the terminal. Either set the 
switch to TALK or push the TALK button. 




To connect your terminal to the system, call one of the phone numbers you were given. When the 
system is available, you hear a constant high-pitched tone. Usually this happens within a few 
rings. If it doesn't, assume the system is not available and try again later. If the line is busy, try 
another phone number, if you have more than one. 
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When you hear a constant high-pitched tone, your next action depends on whether you are using a 
terminal with an acoustic coupler or a data set. 

If the terminal uses an acoustic coupler, insert the phone receiver in the two rubber cups. Usually 
the coupler is marked to indicate how the receiver should be inserted. 



If the terminal uses a data set, either set the switch on the front of the data set to DATA or push 
the DATA button. Then replace the phone receiver. 

Usually an indicator on the terminal lights to let you know that it is connected to the system. Wait 
a full two seconds after the light comes on. You are now ready to log in to the system and do your 
work. 
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Entering the System 

When you log in to the system, your terminal is connected to the main computer using software and 
hardware that is known collectively as a network. A network transfers information hack and forth 
between your terminal and the computer. Control Data offers two types of networks for use with 
NOS: the Control Data Distributed Communications Network (CDCNET) network and the 
Communications Control Program (CCP) network. The login and logout examples in this manual 
were generated using a CCP network. We will note in the examples any differences that may occur if 
you are using CDCNET, though the login and logout process is much the same for both networks. 

In the first section, you were asked to gather some information (your family name, user name, and 
password, and, if applicable, your personal ID). The system now asks you for that information, one 
item at a time. All you have to do is respond with the names you were given. Figures 3-1 and 
3-2 are two examples of logins as they might appear during a terminal session (a terminal session 
begins when you log in and ends when you log out). In the examples: 

• The family name is SYSTEMA. 

• The user name is JLC6021. 

• The password is JLC6. 

These examples do not show the use of the personal identification validation, because the use of the 
personal ID is optional from site to site. If you are required to enter a personal ID during login, the 
prompt for it will appear after you have entered your password. If you are prompted to enter a 
personal ID, simply enter the personal ID supplied to you by your site administrator and then press 
the carriage return. 

Figure 3-1 shows a login with no errors. Figure 3-2 shows a login where the user makes a mistake 
typing the user name; the system asks for all the entries again. Everything that the user types is 
shown in lowercase blue letters. After each entry, the user presses the carriage return. 

Try logging in using the information you were given. After the light that indicates terminal 
connection comes on, wait a full two seconds and then press the carriage return twice. (Depending on 
your terminal, this key may be labeled RETURN, CR, CARRIAGE RETURN, NEXT, SEND, NEW 
LINE, or ETX. If you’re not sure which key is the carriage return, ask someone.) 

The system responds to each carriage return with one or two blank lines. If you don’t see a response, 
press the carriage return again. The system then displays four lines that will look something like 
this: 

WELCOME TO THE NOS SOFTWARE SYSTEM. 

COPYRIGHT CONTROL DATA 1978, yyyy. 

yy/mm/dd. hh.mm.ss. T01A78 

CDC NETWORK OPERATING SYSTEM NOS 2 

The first two lines are always the same. The third line gives the current date (yy/mm/dd) and time 
(hh.mm.ss) and a terminal name (you don’t need to be concerned about the name). The fourth line 
usually identifies your computer center or the system you’re using in more detail. 

At this point, the system may ask for your family name with the following prompt. 

FAMILY: 

If it does, type the family name you were given and press the carriage return. If you are using a 
family name supplied by the system (a default name), pressing the carriage return is the only entry 
you need make. You must spell every entry correctly and follow each entry with a carriage return. If 
you do make a mistake, however, the system gives you an opportunity to retry your entries later. 
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Next, the system asks for your user name with the following prompt. 

USER NAME: 

Type the user name you were given. 

Next the system asks for your password with the following prompt. 

PASSWORD: 

Type the password you were given. Although our examples show the password that is entered, some 
display terminals do not actually display the characters on the screen. Many printing terminals 
overprint several characters on a line and ask that you type your password on that line. 

PASSWORD: 

ilium 

This is done to obscure your password and to protect the security of your user name should you lose 
or throw away paper printed out from a terminal session. Some display screen terminals will also 
overwrite this line with blanks. 

If you are required to enter a personal identification, then the prompt for it will appear after the 
prompt for the password. 


Terminal Session 

Comments 

carriage return 

The user presses the carriage return 
twice to begin the process. Pressing the 
carriage return helps the system 
identify line speed, character set, and 
so forth, of the terminal being used. 1 

carriage return 


WELCOME TO THE NOS SOFTWARE SYSTEM. 
COPYRIGHT CONTROL DATA 1978, yyyy. 


yy/mm/dd. hh.mm.ss. T01A78 

CDC NETWORK OPERATING SYSTEM NOS 2 


FAMILY: systema 

USER NAME: jl c 6021 

PASSWORD:.jlc6 

The user responds to system prompts. 

T01A78 - APPLICATI0N: 2 iaf 

In response to the prompt for an 

YOUR PASSWORD WILL BE EXPIRED yy/mni/dd. 

application name, the user types IAF. 

JSN: AAYJ, NAMIAF 

The system indicates when your 

READY 

password will expire. 


The system indicates that it's ready to 
accept instructions. 


Figure 3-1. Login with No Errors 

J If your site maintains more than one computer, you might be required to select one at this time. 
Refer to a knowledgeable person at your site for any questions regarding this part of the login 
process. 

2 At some sites this may not be required during the initial login process. 
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Terminal Session 

Comments 

carriage return 

The user presses the carriage return 

carriage return 

WELCOME TO THE NOS SOFTWARE SYSTEM. 
COPYRIGHT CONTROL DATA 1978, yyyy. 

yy/mm/dd. hh.nun.ss. T01A6D 

CDC NETWORK OPERATING SYSTEM NOS 2 

FAMILY: systema 

USERNAME: uod6021 

twice to begin the process. Pressing the 
carriage return helps the system 
identify line speed, character set, and 
so forth, of the terminal being used. 1 

The user types the user name 

PASSWORD: jlc6 

IMPROPER LOGIN, TRY AGAIN. 

incorrectly. 

FAMILY: systema 

USERNAME: jlc6021 

This time the user types the user 

PASSWORD: jlc6 

name correctly. 

T01A6D - APPLICATION: 2 iaf 

The user types IAF 

YOUR PASSWORD WILL BE EXPIRED yy/mm/dd. 

in response to the prompt for an 

JSN: ABZH, NAMIAF 

READY. 

application name. 


Figure 3-2. Login with an Error 


If the system displays the message 
IMPROPER LOGIN, TRY AGAIN. 

check the names you just entered; you may have entered one incorrectly. (For example, the letter 0, 
the numeral 0, the letter l, and the numeral 1 each has its own key on the terminal keyboard. If you 
type the letter 0 for the numeral 0 or the letter L for the numeral 1, the system regards it as an error.) 
When the system prompts you, try again. If you are entering everything correctly, but the system 
still gives you the message, tell your computer center personnel. It is a problem that they must 
handle. 

2 If your site maintains more than one computer, you might be required to select one at this time. 
Refer to a knowledgeable person at your site for any questions regarding this part of the login 
process. 

2 At some sites this may not be required during the initial login process. 
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If the system asks you to enter an application name, type 
IAF 

Don't worry if your system does not request all the information indicated in the example terminal 
sessions or mentioned in the text. Your system has been set up to automatically use certain entries 
(defaults) for you. 

When the system is ready for you to continue, it displays another identification line (which you 
needn't be concerned with now) and the word 

READY. 

Now you are at the point where you can do your work. If you have specific instructions, begin them. 
If you want to enter and run a program, go on to section 4. If you have no work ready yet, you can 
either log out (as described below) or continue on to section 4. It contains practice programs that you 
can enter and run to become familiar with the system. When you are done, or at any time you want 
to end the terminal session, follow the instructions given next for leaving the system. 


Leaving the System 

When you have completed your work, or at any time the system is waiting for an instruction, and 
you want to end the terminal session, type 

BYE 

This tells the system that you want to leave. The system displays several lines that, for the examples 
we showed on login, look somewhat like this: 

bye 

UN=J LC6021 
J SN=ABDV 
CHARACTERS’* 

IAF 

LOGGED OUT. 

HOST DISCONNECTED CONTROL CHARACTER=(ESC) 

ENTER INPUT TO CONNECT TO HOST 

It's unlikely that you need to be concerned with these lines. They show the time you ended the 
terminal session, accounting information, the number of input and output characters used during the 
session, and other system information. 

If your system uses CDCNET or is part of a multihost system, you may also see additional 
information on the status of the network displayed at this time. 

If no one is waiting to use the terminal and it was turned off when you found it, turn it off again. If 
an acoustic coupler is used, hang up the phone. If a data set is used, either set the switch to TALK or 
push the TALK button. 


LOG OFF 10.49.38. 

SRU-S 5.059 

55.146KCHS 

CONNECT TIME 00.26.53. 
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Putting the Program on the System 

After you’ve logged in and the system responds 
READY 

you must tell it what language you want to use. This book assumes that you are using FORTRAN 
or BASIC, so type 

FORTRAN 


or 


BASIC 

Your system may have other languages available also; if so, enter the name of the language you 
want to use. Remember, after each line you type, you must press the carriage return. 

For its own use, the system is going to refer to your program as a file. (We’ll talk more about files 
later.) When it asks 

OLD, NEW, OR LIB FILE: 

type 

NEW 

We’re assuming that this is the first time you’ve used the system and that you have no existing 
files (programs). The system now asks what you want to name your file with the prompt 

FILE NAME: 

You can enter any name you want as long as it is made up of letters and/or numbers, begins with 
a letter, and is no more than seven characters. This name can be the same as the name of your 
program, but it need not be. 

When the system is ready, it displays 

READY 

Now you simply begin.typing your program, line by line, with each line followed by a carriage 
return. You must assign a number to each line, so that you can refer to specific lines later. The 
numbers must be sequential, because the system automatically sorts and orders the lines of the 
program according to these line numbers. We recommend numbering by tens, so that you can 
insert lines easily if you want to change the program after you have entered it. 
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The following example shows a user logging in, creating a new file named FORTEST, and 
entering a FORTRAN program that reads two numbers, multiplies them, and prints the result. 

WELCOME TO THE NOS SOFTWARE SYSTEM. 

COPYRIGHT CONTROL DATA 1978, yyyy. 

yy/mm/dd. hh.mm.ss. T01A6D 

CDC NETWORK OPERATING SYSTEM NOS 2 

FAMILY: systema 

USER NAME: jLc6021 

PASSWORD: JLC6 

T01A6D - APPLICATION: iaf 

JSN: ACZH, NAMIAF 

READY. 

fortran 

OLD, NEW, OR LIB FILE:new 
FILE NAME:fortest 
READY. 

10 program test 
20 read *,i,j 
30 i=i*j 
40 print *,i 
50 end 


The following example shows a user logging in, creating a new file named BASTEST, and 
entering a BASIC program that reads two numbers, multiplies them, and prints the result. 

WELCOME TO THE NOS SOFTWARE SYSTEM. 

COPYRIGHT CONTROL DATA 1978, yyyy. 

yy/mm/dd. hh.mm.ss. T01A6D 

CDC NETWORK OPERATING SYSTEM NOS 2 

FAMILY: systema 

USER NAME: jlc6021 

PASSWORD: JLC6 

T01A6D - APPLICATION: iaf 

JSN: ACZR, NAMIAF 

READY. 

basic 

OLD, NEW, OR LIB FILE:new 
FILE NAME:bastest 
READY. 

10 input i,j 
20 i = i * j 
30 print i 
40 end 


Now enter your own program or copy one of the examples. Don’t worry about typing mistakes. We 
explain how to correct them next. 
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Correcting and Changing the Program 

If you see an error in a line before you press the carriage return, you can backspace to the error 
and retype it. The backspace key is usually labeled BACK SPACE, BKSP, — , or something 
similar. (If you can’t find this key on your terminal, ask someone to show you the equivalent key 
or keys.) When you backspace, however, you are in effect erasing every character you backspace 
over, even though it may still appear at the terminal. After you have corrected the error, you must 
retype the rest of the line before pressing the carriage return. 

If you have already pressed the carriage return when you see the mistake, you can still change, 
delete, or insert lines using the line numbers as references. Either you can do this as soon as you 
see the mistake, or you can wait until you’ve entered the entire program. Suppose you entered the 
FORTRAN program in the first example like this: 

10 program test 
20 trsf *,i,j 
30 print *,i 
40 stop 
50 end 

To change a line, simply retype the entire line, including the line number, as you would like it to 
appear. 

20 read *,1,3 

The system automatically replaces the line in the program. 

To delete a single line, such as line 40, type 
delete,40 

The system deletes the entire line that started with 40. 

To delete several consecutive lines, include the first and last line numbers separated by two 
periods. For example, typing 

delete,20..40 

would delete lines 20, 30, and 40 from the program. 

If you leave out a line or find later that you need to add one between two existing lines, pick a 
number between the two existing line numbers. Type it and the new line as you want it to appear. 

25 i = i*j 

The system automatically inserts the new line. 
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If you insert several lines in the same area of a program, you may run out of line numbers. If this 
happens, type 


RESEQ 

and the system resequences the program with new line numbers. To check it, type 
LIST 

and the system prints the resequenced program. 

reseq 

READY. 

List 

00100 PROGRAM TEST 
00110 READ *,I,J 
00120 I=I*J 
00130 PRINT *,I 
00140 END 


With just these techniques, you can correct any program at any time. There are many other ways 
to change a program, but they are essentially short cuts to accomplish the same thing. If you're 
interested, the system's primary editing commands are described in Volume 3, System Commands . 

In addition, there are several text editors which may be available on your system. They provide 
even more capabilities, including the ability to edit lines that don’t begin with line numbers (for 
example, a collection of data). We’ll talk more about text editors in section 5 but if you want to see 
some examples now, go to appendix C. 


Using the Program 

Now that you have a program on the system, you can list it at your terminal, run (or execute) it, 
and save it for future use. 

To list the contents of your program, type 

LIST 

and the system displays the contents of your program, 
list 

10 PROGRAM TEST 
20 READ *,I,J 
25 I=I*J 
30 PRINT *,I 
50 END 

READY. 

To display several consecutive lines, include the first and last line numbers separated by two 
periods. For example, 

list,20..30 

displays lines 20, 25, and 30. 

Using the program you have created, try a few combinations to see how they work. 
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Running a program is the same thing as executing a program. You might hear both terms used. To 
run your program and get the results at your terminal, type 

RUN 

The following example runs the FORTRAN program that was just entered and listed. 

Terminal Session _ Comments_ 


run 

? 4 15 


60 


SRU 0.289 UNTS. 

RUN COMPLETE. 


The system requests data for program 
execution by printing a question mark. 
You enter your data and press the 
carriage return. The system returns the 
result. 

This number is a measure of system use; 
you needn't be concerned with it. 


Remember, typing 
RUN 

runs the program only once. When the system responds 
RUN COMPLETE 

the program is done and the system is waiting for you to tell it what to do next. If you enter 
numbers now, the system assumes you are entering line numbers and it inserts them in your 
program. 

The programs you create at your terminal are temporary. When you log out, they disappear 
completely unless you save them. To save your program, type 

SAVE 

The system makes a copy of the program and puts it in permanent storage under the file name you 
entered earlier. The next time you log in to use the system, ask for the file and the system will 
retrieve it for you. 
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The following example shows how to create, list, run, and save the BASIC program we showed in 
this section. 

READY. 

basic 

OLD, NEW, OR LIB FILErnew 
FILE NAME:bastest 
READY. 


10 

input 

i/j 

20 

i=i*j 


30 

print 

i 

40 

end 


List 


10 

INPUT 

M 

20 

I=I*J 


30 

PRINT 

i 

40 

END 


READY. 



run 

? 7 12 
84 


RUN COMPLETE, 
save 
READY. 


Suppose you end this terminal session, log in later, and want to run the program you saved. When 
the system is ready, type 

OLD 

The system asks which file you want. Enter the name you gave to the file when you created it. 
When the system says 

READY 

the program is available to you as if you had just entered it. You can then use any of the 
commands shown in this section to change it, list it, or run it, as we show in the following 
examples. 
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Terminal Session 


Comments 


WELCOME TO THE NOS SOFTWARE SYSTEM. 

COPYRIGHT CONTROL DATA 1978, yyyy. 

yy/mm/dd. hh.mm.ss. T01A6D 

CDC NETWORK OPERATING SYSTEM NOS 2 

FAMILY: sy sterna The user logs in. 

USER NAME: jlc6021 

PASSWORD: JLC6 

T01A6D - APPLICATION: iaf 

JSN: ACBM, NAMIAF 


READY. 

o Ld The user retrieves the saved file 

FILE NAME:fortest FORTEST. 

READY. 

list FORTEST is listed. 

10 PROGRAM TEST 
20 READ *,I,J 
25 I=I*J 
30 PRINT *,I 
50 END 


READY. 

run 

? 5 30 
150 

SRU 0.286 UNTS. 


FORTEST is run. 


RUN COMPLETE. 

old The user retrieves the saved file 

FILE NAME:bastest BASTEST. 

READY. 

list BASTEST is listed. 

10 INPUT I,J 
20 I=I*J 
30 PRINT I 
40 END 

READY. 

run BASTEST is run. 

? 30 5 
150 

RUN COMPLETE. 


Remember, programs that you saved are not automatically available at the terminal when you log 
in. You must ask for them explicitly. 

Notice that you didn't have to tell the system what language you wanted to use this time. That's 
because the system remembers what language you were using when you saved the file. 
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Getting Help 

The instructions you give the system are called commands. Many commands are actually the word 
that describes the operation you want the system to perform, like LIST or SAVE. If you can’t 
remember the name of a command or want to know more about that command, type 

HELP 

Then just follow the instructions. 

The system gives you three choices and asks you to pick one. 

• You can get help with a particular command. 

• You can read from a manual that will be displayed at your terminal. 

• You can see a list of acceptable commands. 

When you choose to get help with a particular command, the system tells you what the command 
does and then prompts you for any information needed to use the command, such as a file name. 
When it has the information it needs, the system performs the command. 


Interrupting a System Operation! 

To interrupt a system operation, such as running or listing a program, hold down the control key 
(labeled CONTROL, CTRL, or something similar) and press 

P 

Then release both keys and press the carriage return. (This combination of keys is called the 
interruption sequence. If it doesn’t work on your terminal, ask someone what the equivalent key or 
keys are. You may want to record this sequence on the information sheet in section 1.) 

The system displays 

★INTERRUPTED* 

To continue the operation, press the carriage return. 


Stopping a System Operation! 

To stop a system operation, such as running or listing a program, hold down the control key (labeled 
CONTROL, CTRL, or something similar) and press the 

T 

Then release both keys and press the carriage return. (This combination of keys is called the 
termination sequence. If it doesn’t work on your terminal, ask someone what the equivalent key or 
keys are. You may want to record this sequence on the information sheet in section 1.) 

The system displays 

★TERMINATED* 

You can then enter a new command. 

t If your site is using CDCNET, then the key sequences used to interrupt or terminate a system 
operation will be different from the ones listed here. Contact your site personnel for help or refer to 
the CDCNET Terminal Interface Usage Manual. 
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In the preceding section you used only one file at a time, the one that held your program. As you 
use the system more, you will probably want to have several files available during a terminal 
session. To use files effectively, you should know some things about them and the commands you 
use to manipulate them. 

A file is a collection of information that you and the system refer to by a common name. A file 
contains anything you want, for example, a program, data to be used in a program, data resulting 
from the execution of a program, text data, or reports. A file is either permanent or temporary. 


Permanent Files 

Permanent files are those that you explicitly save during a terminal session. You can retrieve them 
from permanent storage at any time. When you retrieve a permanent file, the system makes a copy 
of the file for you to use. Any changes you make to the file are only on the copy; the actual file in 
permanent storage is not changed. To save the changed version of the file, you must either replace 
the permanent file with the changed version or save the changed version as a new file with a new 
file name. 


Temporary Files 

All files that you use at your terminal during a terminal session are temporary. That is, they 
disappear when you log out. This includes the copy of a permanent file, although the permanent 
file itself is kept for you by the system. You create or bring a file to the terminal: 

• As a new, empty file (as we did when entering the program in the preceding section). 

• As a copy of a permanent file (as we did when retrieving the program in the preceding section). 

• As data resulting from the execution of a program. 

You can designate one of your temporary files as the primary file (we describe how later in this 
section). In fact, the program you created in the preceding section was a primary file. The primary 
file has some special features. 

• You can enter information into a primary file either directly from the keyboard (as we described 
in the preceding section) or by using the TEXT command (which we describe later in this 
section). 

• You can edit the primary file using line numbers (also described in the preceding section). 

• The primary file is the file the system uses by default if you don’t specify a file name on a 
command. That’s why you could list, run, and save your program by entering only the name of 
the command. There are a few special file names that you shouldn’t use when naming your 
primary files. For example, avoid names that start with several Z’s as well as names that start 
with the letters SCR. If you do choose to begin your file names with these letters, some of the 
system commands may not work for you. 
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The primary file is positioned to its beginning before every operation performed on it. The 
system has a pointer that keeps track of where you are within a file. For example, as the system 
lists a file, the pointer moves down the file. When the pointer reaches the end of the file, the 
system stops listing. If the file is a primary file, the system automatically goes back to the 
beginning (rewinds the file) before the next operation. That's why you could use your program 
in the preceding section without worrying about where you were positioned within the file. The 
system does not automatically rewind nonprimary files. Before every use, you must enter a 
command (REWIND) to rewind them. 

You will usually have one file that you use more than the others. Typically it is the file containing 
your program. Therefore, you will probably make that file your primary file and use one or more 
nonprimary files for data to be used in and/or resulting from your program's execution. 

In the rest of this section, we use some figures to illustrate how file commands work. The symbol 
□ represents a primary file. If the box is shaded, H , it represents a nonprimary file. The name 
of the file is in the upper left corner. The relative positions of the files have no significance. Figure 
5-1 illustrates primary and nonprimary files. 



Figure 5-1. Primary and Nonprimary Files 


In this section, you will also learn how to specify a particular file name on a command. Wherever 
you have to fill in the name of one of your files, the word filename is shown in lowercase letters. 
You must still enter anything shown in uppercase letters exactly as shown. For example, 

SAVE,fiLename 

means you can save a file by typing 
SAVE, 

followed by the name of the file. 
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Designating a Primary File 

In the preceding section you created a primary file by specifying a programming language 
immediately after logging in and responding to prompts by the system. At any time during a 
terminal session you can also create a new, empty file and designate it the primary file simply by 
typing 

NEW 

The system then asks you for the new file's name as before. If you want to combine these two 
steps, you can include the file name with the NEW command like this: 

NEW,filename 

All of the files that were available at your terminal, including the old primary file, disappear (files 
in permanent storage are not affected). If you want to keep them available, include /ND (for no 
drop) in the command like this: 

NEW,filename/ND 

The old primary file then becomes a nonprimary file available at the terminal. Figure 5-2 
illustrates the NEW command. Figure 5-3 shows it in an example. 


Sequence of Files Available 

User Entries at the Terminal 


NEW,A 

Creates an empty 
primary file named A. 


NEW,B 

Creates a new, empty 
primary file named B. 
File A disappears. 


B 


NEW, C/ND 

Creates a new, empty 
primary file named C. 
File B becomes a non¬ 
primary file still available 
at the terminal. 




c 

' • '4 




Figure 5-2. Creating a New, Empty File and Designating It the Primary File (NEW 

Command) 
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Terminal Session 

Comments 

fortran 



READY. 



new,octfile 

The user creates a new, empty 

READY. 


primary file named 

OCTFILE. 

10 

program octa L 

The user enters a FORTRAN 

20 

read 100,j 

program that converts a 

30 100 

format Ci4) 

decimal number to octal. In 

40 

print 200,j,j 

this example, many spaces 

50 200 

format(2x,i4,' decimal = *,010,* octal*) 

are typed between the line 

60 

end 

number and the beginning of 
the FORTRAN statement, 
although only one space is 
required. The additional 
spaces allow FORTRAN 
statement numbers to be 
easily identified. 



The program is run 

run 


successfully. 

? 8 


8 

DECIMAL = 0000000010 OCTAL 


SRU 

0.314 UNTS. 


RUN COMPLETE. 


save 


The user saves file OCTFILE. 


Figure 5-3. Example of Creating and Saving a Permanent File 


You use NEW only when creating a new, empty file. To designate a file already existing at your 
terminal as the new primary file, type 

PRIMARY,fi Lename 

filename is the name of the file you are designating as primary. The old primary file is changed to 
a nonprimary file and remains available at the terminal. Other files at the terminal are not 
affected by this command. 
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Figure 5-4 illustrates the PRIMARY command. 


Sequence of 
User Entries 


Files Available 
at the Terminal 


User has already 
created three files, 
A, B, and C. A 
is the primary file. 



PRIMARY,B 

Makes file B the 
primary file. File 
A becomes a non¬ 
primary file. File 
C is not affected. 



Figure 5-4. Designating an Existing File as the Primary File (PRIMARY Command) 


Entering Information into the Primary File 

You can enter information into the primary file either directly (as we described in the preceding 
section) or by using the TEXT command. Previously, you entered lines with line numbers. The 
TEXT command allows you to enter information without line numbers. Typically, it is used to 
create files containing data or text rather than a program. 

First, create a new, empty primary file with the NEW command. Then type 

TEXT 

When the system responds 
ENTER TEXT MODE. 

enter the information without line numbers, ending each line with a carriage return. 
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If you see a mistake on a line before you've pressed the carriage return, either you can backspace 
over the mistake and reenter the line from that point, or you can delete the line by holding down 
the control key (labeled CONTROL, CTRL, or something similar) and pressing the X key, then 
releasing them and pressing the carriage return. (This is called the cancel line sequence. If this 
sequence doesn't work on your terminal, ask someone what the equivalent key or keys are. You 
may want to record this sequence on the information sheet in section 1.) 

In text mode, once you have entered a line and pressed the carriage return, you can’t change the 
line unless you use one of the system's editing facilities, such as the Full Screen Editor. Refer to 
appendix C for some basic Full Screen Editor commands. If the Full Screen Editor is not available 
on your system, try one of the other editors, XEDIT or Text Editor. You can find out how to use 
XEDIT, Text Editor, and more about the Full Screen Editor from the manuals listed in the preface. 

When you are finished entering information and are at the beginning of a new line, press either 
the ETX key, the interruption sequence (usually the control key and the P key), or the termination 
sequence (usually the control key and the T key). Then press the carriage return. The system 
responds: 

EXIT TEXT MODE. 

To add more lines, type 
TEXT 

and repeat the procedure. The new lines are added to the end of the file. Figure 5-5 shows a user 
creating a file that contains data to be used in a program. 


Terminal Session 

Comments 

new,data 

The user creates an empty primary file 

READY. 

text 

ENTER TEXT MODE. 

named DATA. 

3 4 5 

2 1 5 

1.5197 1.5197 1.5197 

0 0 0 

The user enters four lines of data. 

The user exits text mode using either the 

EXIT TEXT MODE. 

READY. 

ETX key, interruption sequence, or 
termination sequence. 

list 

If the system had not been in text mode 

3 4 5 

when these numbers were entered, it 

2 1 5 

would have assumed the numbers were 

1.5197 1.5197 1.5197 

0 0 0 

line numbers and resequenced them. 


Figure 5-5. Example of Creating a Data File 
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When you’re entering text into a primary file in text mode, you might want to use uppercase and 
lowercase letters. On most terminals, your entry appears as lowercase letters but the system 
automatically converts it to uppercase letters. To tell the system not to convert lowercase letters to 
uppercase letters, type 

ASCII 

before entering text mode. When you are done using text mode and want to return to the normal 
mode of operation, type 

NORMAL 

The system then begins converting lowercase letters to uppercase again. You shouldn’t mix ASCII 
and normal mode when entering data into a file. Lowercase letters entered under ASCII mode are 
translated incorrectly if they are listed under normal mode. 

Figure 5-6 shows a user entering uppercase and lowercase letters in ASCII mode. 
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Terminal Session 


new,exam1 

READY. 

text 

ENTER TEXT MODE. 

this is an example of lowercase 
letters entered in normal mode. 


EXIT TEXT MODE. 

READY. 

list 

THIS IS AN EXAMPLE OF LOWERCASE 
LETTERS ENTERED IN NORMAL MODE. 

READY. 
new / exam2 
READY, 
asci i 
READY, 
text 

ENTER TEXT MODE. 

This shows entry of lowercase 
letters and UPPERCASE LETTERS 
in ASCII mode. 


Comments _ 

The user creates an empty primary file. 

The user enters text in lowercase letters. 
The user exits text mode. 

The system converts lowercase letters to 
uppercase letters. 

The user creates a new primary file. 

The user enters text in uppercase and 
lowercase letters. 


EXIT TEXT MODE. 


The system does not convert lowercase 
letters to uppercase. 

READY. 

normal 


READY. 

list 

This shows entry of lowercase 
letters and UPPERCASE LETTERS 
in ASCII mode. 


Figure 5-6. Example of Using ASCII Mode 
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Saving a File 

As we said in the preceding section, to save a primary file, just type 
SAVE 

To save a nonprimary file, include the file name like this: 

SAVE,filename 

Figure 5-7 illustrates the SAVE command. Figure 5-3 shows it in an example. 

If you already have a permanent file with that name, the system tells you 
filename ALREADY PERMANENT 

To replace the file in permanent storage with a copy of your primary file, type 
REPLACE 

To replace a file in permanent storage with a copy of a nonprimary file, include the file name like 
this: 

REPLACE,filename 

Figure 5-8 illustrates the REPLACE command. Figure 5-9 shows it in an example. 

The language you are using when you save or replace a file is automatically associated with the 
file when you retrieve it. You don’t need to enter the name of the language. 


Sequence of Files Available Files in 

User Entries at the Terminal Permanent Storage 


User has already 
created files A and 

B. File A is the 
primary file. 

A 


B 



SAVE 

Saves primary file 

A by making a copy 
in permanent storage. 





A 


B ' " 


A 


Files at the terminal 
are not affected. 





SAVE,B 

Saves nonprimary 
file B. In permanent 
storage there is no 

A 


B ' j 

j 


A 


B 


distinction between 
primary and nonprimary 
files. 


Figure 5-7. Saving Files (SAVE Command) 
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Figure 5-8. Replacing Files in Permanent Storage with Changed Copies (REPLACE 

Command) 
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Terminal Session 


Comments 


old.octfile 

The user retrieves a copy of the 

READY. 


saved file OCTFILE as the 

List 


primary file and lists it. 

10 

PROGRAM OCTAL 


20 

READ 100,J 


30 100 

FORMAT(14) 


40 

PRINT 200 / J,J 


50 200 

FORMAT(2X,I4, 1 DECIMAL = ' 010 ’ OCTAL 1 ) 


60 

END 


READY. 

13 

print 50 

The user changes the temporary 

16 50 

format( 1 enter a decimaL number') 

copy of the file at the terminal. 

run 

ENTER A 

DECIMAL NUMBER 

The program runs successfully 

? 16 


with the changes just entered. 

16 

DECIMAL = 0000000020 OCTAL 


SRU 

0.314 UNTS. 



RUN COMPLETE. 

rep La ce The user replaces OCTFILE in 

READY. permanent storage with the copy 

of OCTFILE that includes the 
changes. 


Figure 5-9- Example of Retrieving and Replacing a Copy of a Permanent File 
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Retrieving a Copy of a Permanent File for 
Use as a Primary File 

To retrieve a copy of a permanent file and make it the primary file, type 
OLD 

The system asks for the name of the file. To combine these two steps, include the file name in the 
command like this: 

0LD,filename 

If you already have a primary file, it and all other files currently at your terminal are no 
available to you at the terminal. To keep them at the terminal, include /ND (for no drop) 
command like this: 

0LD,filename/ND 

The old primary file (if there was one) becomes a nonprimary file and remains available, 
with the other files. 

If the system displays 

filename NOT FOUND. 

you have no permanent file with that name. Check your spelling of the file name. If you're not sure 
whether the name is correct, type 

CATLIST 

This command gives you a list of all your permanent files. It's possible you saved the file using a 
slightly different name than you remember. 

The language you were using when you saved the file is associated with the file automatically 
when you retrieve it. You don't need to enter the name of the language. 


longer 
in the 


along 
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Figure 5-10 illustrates the OLD command. Figure 5-9 shows it in an example. 


Sequence of 
User Entries 


Files Available Files in 

at the Terminal Permanent Storage 


User has just 
logged in. 


OLD,A 

Makes a copy of 
saved file A for use 
as the primary file. 


OLD,B 

Makes a copy of 
saved file B for use 
as the primary file. 
Copy of file A is no 
longer available at 
the terminal. 

OLD f C/ND 

Makes a copy of 
saved file C for use 
as the primary file. 
File B becomes a 
nonprimary file still 
available at the 
terminal. 



Figure 5-10. Retrieving Copies of Permanent Files as Primary Files (OLD Command) 
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Retrieving a Copy off a Permanent File ffor 
Use as a Nonprimary File 


To retrieve a copy of a permanent file for use as a nonprimary file, type 
GET, 

and the name of the file like this: 

GET,fiLename 

Remember, since it is not a primary file, you must specify the file name when you want a 
command to operate on a nonprimary file. 

To list the contents of the file at the terminal, type 

LIST,F=fiLename 

Nonprimary files are not repositioned before every operation as is the primary file. If you try to 
perform an operation using a nonprimary file and it doesn't work correctly, the file may be 
positioned at its end. 

REWIND,filename 

and try the command again. 

You can't edit a nonprimary file simply by entering the changes with line numbers. The system 
would assume that you wanted the changes made to your primary file. To edit a nonprimary file, 
you must use one of the text editors available on your system. Appendix C shows you how to edit a 
nonprimary file using Full Screen Editor. 

Figure 5-11 illustrates the GET, LIST, and REWIND commands. 
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Sequence of 
User Entries 


Files Available 
at the Terminal 


Files in 

Permanent Storage 


User has just 
logged in. 


Makes a copy of 
file A for use as 
the primary file. 


Makes a copy of 
file B for use as a 
nonprimary file. 


Prints the contents 
of primary file A 
at the terminal. 


Prints the contents 
of nonprimary file B 
at the terminal. 


REWIND,B 

Repositions file B to 
its beginning. (Primary 
file A is automatically 
repositioned before 
every operation on it.) 


Figure 5-11. GET, LIST, and REWIND Commands 
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Changing a Permanent File 

You can change a permanent file that has line numbers the same way you changed a program in 
the preceding section. First you must make it the primary file, using either the OLD or PRIMARY 
command. Then follow the same directions for line replacement, deletion, and insertion given in 
the preceding section. 

You can change a nonprimary file either by making it the primary file and using the methods we 
described in the preceding section or by using one of the text editors available on your system. 
Appendix C describes some basic Full Screen Editor directives. 

Examples of permanent file changes are shown in figures 5-9 and 5-12. Remember, the system 
changes only the copy at your terminal. To save the changes, you must either replace the file in 
permanent storage with your changed copy or, if you want to save the changes and also keep the 
original version of the file, save the changed copy with a new file name. 

SAVE,oldname=newname 

Then the original version remains as it was and the changed version of the file is saved. Figure 
5-13 illustrates this variation of the SAVE command. Figure 5-12 shows it in an example. 
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Terminal Session 


Comments 

old,oct fiLe 


The user retrieves a copy of 

READY. 


the saved file OCTFILE as 

L i st 


the primary file and lists 

10 PROGRAM OCTAL 


it. 

13 PRINT 50 

16 50 FORMAT('ENTER A DECIMAL NUMBER') 

20 READ 100,J 

30 100 FORMAT(14) 

40 PRINT 200,J,J 

50 200 FORMAT(2X,14,' DECIMAL = 1 ,010,• 

OCTAL') 


60 END 

READY. 

10 program hex 


The user changes the copy. 

50 200 format(2x,i4,' decimal = ',z10,' 

hexadecima l 1 ) 


run 


The program runs 

ENTER A DECIMAL NUMBER 


successfully with the 

? 16 


changes just made. (The 

16 DECIMAL = 0000000010 HEXADECIMAL 


number entered is 
converted to hexadecimal 

SRU 0.313 UNTS. 


rather than octal.) 

RUN COMPLETE. 

save,octfile=hexfile 


The user saves the 

READY. 


changed version of 

OCTFILE as a new file 
named HEXFILE. Both 
the original file and the 
modified file, OCTFILE 
and HEXFILE, exist in 
permanent storage. 


Figure 5-12, Saving a File with Changes Under a New Name 
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Sequence of 
User Entries 


Files Available 
at the Terminal 


Files in 

Permanent Storage 


User has already 
retrieved a copy 
of file A as the 
primary file. 


User makes changes to 
the copy of file A at 
the terminal. 


A 



SAVE,A=D 

Saves a copy of the 
changed version of 
file A under the file 
name D. The changed 
file A is still available 
at the terminal. 


OLD f A 

Retrieves the original 
file A. 


OLD,D 

Retrieves file D (the 
changed version of 
file A). 





Figure 5-13. Saving Both the Original and Changed Versions of a File (SAVE Command) 
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Listing and Rewinding Files 

The commands to list and rewind files have already been mentioned briefly. In summary: 

• To list the contents of a primary file, type 

LIST 

• To list the contents of a nonprimary file, type 

LIST,F=filename 

• To rewind a nonprimary file, type 

REWIND,fiLename 

Remember to rewind nonprimary files, particularly a file containing data to be used in program 
execution (refer to section 6). If you run the program once and then run it a second time without 
rewinding the data file (which is nonprimary), the program won’t produce the correct results because 
it has no data (that is, because the system pointer is at the end of the nonprimary file). 

Listing the Names of Your Permanent Files 

To get a list of your permanent files, type 
CATLIST 

and the system displays the names of your files similar to this, 
catlist 

CATALOG OF JLC6021 FM/SYSTEMA 82/03/19.16.57.31. 

INDIRECT ACCESS FILES 

BASTEST DATA FORTEST HEXFILE OCTFILE 

5 INDIRECT ACCESS FILES, TOTAL PRUS = 5. 

The files you’ve saved are called indirect access files, because you access a copy of the file, not the file 
itself. The TOTAL PRUS entry at the bottom refers to the size of your files. It’s unlikely that you 
need be concerned with this entry. 
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Removing a Permanent File from the System 

To remove the permanent file associated with your primary file, type 

PURGE 

To remove other permanent files, type 
PURGE/f iLename 

If you were using a copy of the file at your terminal, it is still available, but it disappears when you 
log out. Figure 5-14 illustrates the PURGE command. 


Sequence of 
User Entries 


User has already 
retrieved a copy 
of file A as the 
primary file. 


Files Available 
at the Terminal 


Files in 

Permanent Storage 


PURGE 

Purges the primary file 
A from permanent 
storage. The copy of 
file A is still available 
at the terminal until the 
terminal session ends. 




PURGED 

Purges file D from 
permanent storage. 
The file to be purged 
doesn't have to be at 
the terminal. 




C 


Figure 5-14. Purging Files in Permanent Storage (PURGE Command) 
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So far in this manual, the system has requested data for program execution (input data) by 
displaying a question mark at the terminal and waiting for you to enter the data from the 
keyboard. The system then displayed the results of program execution (output data) at the 
terminal. 

However, if you have a lot of data to enter, you can put it on a file and instruct the system to get 
the data from the file (that is, to read the file). In the same way, if you expect a lot of data to be 
displayed as the result of program execution, you can create a file and instruct the system to enter 
the results in the file (that is, to write the file). 


Reading and Writing Data Files in FORTRAN 

In order for the system to read or write a file used within a FORTRAN program, you must first 
associate a number with the file using the FORTRAN OPEN statement. 

OPEN (UNIT=number,FILE=' filename') 

The number is a number you choose between 1 and 99. In the FORTRAN program, this number is 
associated with the file that you name following FILE=. 

The file name follows the rules you've used previously to create file names. It can be both letters 
and numbers, must begin with a letter, and must be no more than seven characters. You must 
include an apostophe (’) before and after the file name. 

For example, in order for the system to read and write files named DATA and RESULT, you could 
use the OPEN statements: 

OPEN (UNIT=76,FILE='DATA') 

OPEN (UNXT=3,FILE= I RESULT 1 ) 

After associating a number with the file, you must specify that number in a FORTRAN READ or 
WRITE statement like this: 

READ(number,format)variables 

WRITE(number,format)variables 

In both these statements, number is the number associated with the file in the OPEN statement, 
format is the statement number of the appropriate FORMAT statement, and variables is a list of 
the FORTRAN variables you want to read or write. 

To read variables A, B, and C from file DATA, you could use a READ statement like this: 
READ(76,100)A,B,C 

To write A, B, and C on file RESULT, you could use a WRITE statement like this: 

WRITE(3,200)A,B,C 

If file RESULT does not exist when the WRITE statement is executed, the system creates it. 

Figure 6-1 shows how to connect a file to a FORTRAN program. 
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Terminal Session 


Comments 


old,forarea 
REA DY. 

I i st 

10 PF 

20 OF 

30 1 RE 

40 100 FC 

50 If 

60 S 

70 RE 

80 IF 

90 AF 

100 PF 

110 200 FC 

120 GC 

130 2 CC 

140 PR 

150 300 FC 

160 GC 

170 EN 


PROGRAM TRY 

OPEN (UNIT=3,FILE='DATA ') 

READ (3,100) A, B, C 
FORMAT C3F7.0) 

IF (A .EQ. 0.0) STOP 
S = (A + B + C) / 2.0 
RDCL=S * (S-A) * (S-B) * CS-C) 

IF (RDCL -LT. 0.0) GO TO 2 
AREA = SORT (RDCL) 

PRINT 200, A, B, C, AREA 

FORMAT (’SIDES ARE 1 ,3F9.4,/,'AREA IS »,F11.4/) 

GO TO 1 
CONTINUE 

PRINT 300, A, B, C 

FORMAT ('SIDES OF ',3F9.4,' FORM AN INVALID TRIANGLE',/) 

GO TO 1 

END 


The user retrieves a 
program created earlier 
and lists it. The 
program reads three 
numbers, which are 
sides of a triangle, and 
calculates the area of 
the triangle. 


READY, 
get,data 
READY, 
list ,f=data 
3.0000 4.0000 5.0000 
2.0000 1.0000 5.0000 
1.5197 1.5197 1.5197 
0 0 0 


The user now retrieves a 
file that was created 
earlier in text mode and 
lists it. It contains data 
for three triangles and, 
to terminate execution, 
a zero line. 


OEND-OF-FILE ENCOUNTERED ON FILE DATA 
FTN - FATAL ERROR NUMBER 65 

TRACEBACK INITIATED BY SYSERR AT REL(ABS) ADDRESS 122(15737). 

CALLED BY FECESE. AT ADDRESS 304(16073) WITH NO AP-LIST. 

CALLED BY INPC= AT ADDRESS 227(5226) WITH NO AP-LIST. 

CALLED BY TRY AT LINE 20, ADDRESS 22(133) WITH APLIST 11631 (11742). 
.014 CP SECONDS EXECUTION TIME. 

SRU 0.352 UNTS. 


This is included to show 
an error. The RUN 
command causes the 
program to be compiled 
and executed. The 
program runs but no 
results appear, because 
the user did not rewind 
the file after listing it. 


RUN COMPLETE, 
rewind,data 
READY, 
run 

SIDES ARE 
AREA IS 
SIDES OF 
SIDES ARE 
AREA IS 


3.0000 
6.0000 
2.0000 
1.5197 
1.0000 


4.0000 5.0000 


1.0000 

1.51 97 


5.0000 FORM AN INVALID TRIANGLE 
1.51 97 


The user rewinds the 
file, and the program is 
executed again. This 
time the results appear. 


0.349 UNTS. 


RUN COMPLETE. 


Figure 6-1. Connecting a File to a FORTRAN Program 
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Reading and Writing Data Files in BASIC 

In order for the system to read or write a file used within a BASIC program, you must first 
associate a number with the file, using one or more FILE statements in the BASIC program. 

FILE #number =,, f i lename" 

You must include the number sign (#) before the number, the equal sign (=) before the file name, 
and quotation marks (”) before and after the file name. The number can be between 1 and 131071. 
The file name can be both letters and numbers, must begin with a letter, and must be no more than 
seven characters. To specify more than one file, you can either put them on one FILE statement 
separated by commas or put one file each on several FILE statements. 

For example, to allow the system to read and write files named DATA and RESULT, you could 
use: 

FILE #76="DATA",^"RESULT" 
or 

FILE #76="DATA" 

FILE #3= M RESULT" 

After associating a number with the file in a FILE statement, you must specify that number in a 
BASIC INPUT (read) or PRINT (write) statement like this: 

INPUT ^number,variables 

PRINT ^number,variables 


or 


PRINT ^number USING linenumber variables 

In all forms of the statements, variables is a list of the BASIC variables you want to read or write. 
In the PRINT USING statement, linenumber is the line number of the image line to follow when 
printing. 

To read variables A, B, and C from file DATA, you could use an INPUT statement like this: 

INPUT #76,A,B,C 

To write A, B, and C on file RESULT, you could use either: 

PRINT #3,A,B,C 


or 


PRINT #3 USING 180,A,B,C 

If file RESULT does not exist when the PRINT statement is executed, the system creates it. 
Figure 6-2 shows how to connect a file to a BASIC program. 
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Terminal Session 


Comments 


oLd,basarea 

READY. 


List 


10 

FILE #3 = "DATA'' 


20 

INPUT #3, A, B, C 


30 

IF A = 0 THEN 140 


40 

S = (A + B + C) / 2 


50 

R = S * (S-A) * (S-B) 

* CS-C) 

60 

IF R < 0 THEN 110 


70 

X = SQR(R) 


80 

PRINT "SIDES ARE ",A, 

B, C 

90 

PRINT "AREA IS ",X 


100 

GOTO 20 


110 

PRINT "SIDES ARE ",A, 

B, C 

120 

PRINT "INVALID TRIANGLE" 

130 

GOTO 20 


140 

END 



READY, 
get ,data 
READY. 

List,f=data 
3 4 5 
2 1 5 

1.5197 1.5197 1.5197 

0 0 0 

READY. 

run 

END OF DATA ON FILE AT 20 
BASIC EXECUTION ERROR 

RUN COMPLETE. 


The user retrieves a program created 
earlier and lists it. The program reads 
three numbers, which are sides of a 
triangle, and calculates the area of 
the triangle. 


The user now retrieves a file that was 
created earlier in text mode and lists 
it. It contains data for three triangles 
and, to terminate execution, a zero 
line. 


This is included to show an error. The 
RUN command causes the program to 
be compiled and executed. The 
program runs but no results appear, 
because the user did not rewind the 
file after listing it. 


rewind,data 
READY, 
run 

SIDES ARE 3 4 5 

AREA IS 6 

SIDES ARE 2 1 5 

INVALID TRIANGLE 

SIDES ARE 1.51 97 1.51 97 1.5197 

AREA IS 1.00004 


The user rewinds the file, and the 
program is executed again. 

This time the results appear. 


RUN COMPLETE. 


Figure 6-2. Connecting a File to a BASIC Program 
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This section describes some of the more common problems that users have and suggests some 
possible solutions. If you have difficulty after reading this, ask your employer, instructor, or 
computer center personnel for help. 


Setting Up Your Terminal 

If you’re having problems with your terminal and aren’t sure of the proper switch settings, try 
these. They are the most common. 

• Duplex switch set to HALF. If you enter data but nothing is printed, check the duplex switch on 
your terminal; it is probably set incorrectly. 

• Parity switch set to EVEN. 

• Line-speed switch set to match the speed of the phone line you plan to use. If you’re not sure of 
the speed you should use, set the switch to any position (usually 10 to 30 characters per second). 
The system may be able to detect automatically what line speed you are using. 

• The line/local switch (sometimes called the mode switch) set to the line (online) position. 

Make sure the terminal is plugged in and turned on. If a separate acoustic coupler is used, it too 
must be turned on. For any type of acoustic coupler, check that the phone receiver is inserted with 
the cord facing the correct direction. 


During the Dialing Process 

If you dial the phone number and it rings unanswered or is busy, either the system may not be 
operating, or the maximum number of users may be using that phone line already. Try other 
numbers if you have them. If you still get no response (response is a constant, high-pitched tone), 
try again later. 


During the Login Process 

If you hear the high-pitched tone, connect your terminal, and press the carriage return twice, but 
don’t get a login message, go back to Setting Up Your Terminal in this section and check the 
switch settings mentioned. If the switches are all set correctly and the system still doesn’t print 
anything at your terminal, tell your computer center personnel. It may be a problem with the 
equipment. 
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If the login sequence has started and the system displays the message 


IMPROPER LOGIN, TRY AGAIN. 

you’ve entered some of your login information incorrectly. The system prompts you for the 
information again and you can retry the procedure. If this happens four times, the system assumes 
you are not an authorized user; it displays 

USER RETRY LIMIT. 

LOGIN TERMINATED. 

and disconnects the terminal. If this happens, tell your computer center personnel. They will help 
you with the problem. 

If you get the message 

MULTIPLE CONCURRENT LOGINS PROHIBITED 

your site does not allow you to have more than one network application running at a time. Usually 
this means that you are logged into the system at one terminal and you are currently attempting 
to log into the system at a second terminal. In order for you to log into the system through the 
second terminal, you must first log out of the system at the first terminal. 

If you have received this message and you are not currently logged in at another terminal, then 
contact a knowledgeable person at your site for more help. 

If you get the message 

INVALID APPLICATION, TRY AGAIN. 

and the system prompts you for an application, enter 

IAF 

If you get the same message, or the message 

APPLICATION RETRY LIMIT. 

LOGGED OUT. 

tell your computer center personnel. 

1 When you get the message 

APPLICATION NOT PRESENT. 


or 


CONNECTION REJECTED. 

log out and try again later. You haven’t made any mistakes; the system is just not available at 
this time. If you continue to get the 

CONNECTION REJECTED 

message, tell your computer center personnel. 

| The message 

TIMEOUT. 

means you waited too long to respond to a request from the system. Usually the time limit during 
the login procedure is 2 minutes. If this happens, connect your terminal again and retry the login 
sequence. 
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During the Terminal Session 

When the system can’t understand what you want done, or when it detects an error of any sort, it 
tries to diagnose the problem and to give you a message that explains the error and tells you what 
to do. At any time during your terminal session, you may get messages such as 

INCORRECT COWIAND 

that indicate you’ve entered information that the system doesn’t recognize. If this happens, check 
your last entry to make sure that everything is spelled correctly and that commas are included 
where required. Remember that the letter 0, the numeral 0, the letter L, and the numeral 1 each 
has its own key on the terminal keyboard. If you type the letter 0 for the numeral 0, or the letter L 
for the numeral 1, the system regards it as an error. 

If you get a system message that you don’t understand, refer to Volume 3 of the NOS 2 Reference 
Set, appendix B, for more information. 

At times, you may get messages that do not come from the system but instead, come from the 
programming language you are using. These messages usually appear when you try to compile or 
run a program that has an error in it. Most programming languages have reference manuals that 
explain these messages. The manual that you will need depends on the language you are using. 
For example, if you try to run a BASIC program and you get a message telling you that you made 
an error, refer to the BASIC Reference Manual for an explanation of that message. 

If the terminal gives you some sort of audible signal and displays the message 

TERMINAL TIMEOUT IN 30 SECONDS- 

you are waiting too long to enter an instruction (command) or data. The default time limit is 10 
minutes, but it may be different at your site. Check with your site administrator to be sure. 

When you get this message, any entry, even a carriage return, is sufficient to keep the terminal 
active. If you don’t enter anything within 30 seconds of the signal, the system logs you out 
automatically. You can log in again and try to resume your work as described in After Accidental 
Disconnection from the System later in this section. 


NOTE _ 

Output queued in the network can be lost in the event of terminal timeout. If you suspend output to 
the terminal (for example, you strike any key while running a program that is sending 
information to the terminal) and a timeout occurs, continuation of the session can cause the output 
to be lost. 
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During Program Execution 

If you get the message 

★TIME LIMIT* 

ENTER T TO CONTINUE OR CR KEY TO STOP 
your program needs more time to execute. Just follow the directions; type 
T 

to get more time or press the carriage return to stop the program. 

If you get the message 

*$RU LIMIT* 

ENTER S TO CONTINUE OR CR KEY TO STOP 
your program needs more system resources. Again, just follow the instructions; type 
S 

to continue your program execution or press the carriage return to stop the program. 

If these messages continue during program execution, be sure to check your program for any 
errors that may be present, such as incorrect loop statements. 

Any time you want the system to stop what it’s doing, hold down the control key (labeled 
CONTROL, CTRL, or something similar) and press the T key. Then release both keys and press 
the carriage return. (This combination of keys is called the termination sequence. If it doesn't work 
on your terminal, ask someone what the equivalent key or keys are.) 


After Accidental Disconnection from the System 

A mechanical failure or system malfunction may disconnect you from the system unexpectedly. If 
this happens, log in again. The system tells you if you can recover your work by listing one or 
more recoverable jobs. The system refers to your terminal session as a job and gives it a job 
sequence name (JSN). You may have noticed a job sequence name being printed during the login 
process. The job sequence name printed during your previous login should match the name of the 
job that the system says you can now recover. 


NOTE _ 

If your site maintains more than one network, always use the same network when you attempt to 
recover a job unless you have no other alternative. 


To continue your previous terminal session, type the job sequence name. To start a new session, 
type 

GO 

Figure 7-1 shows a user being disconnected, logging back in, and resuming work from the previous 
terminal session. 
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Terminal Session 


Comments 


WELCOME TO THE NOS SOFTWARE SYSTEM. 
COPYRIGHT CONTROL DATA 1978, yyyy. 

yy/mm/dd. hh.mm.ss. T01A6D 

CDC NETWORK OPERATING SYSTEM NOS 2 

FAMILY: systema 

USER NAME: j Lc6021 

PASSWORD: jlc6 

T01A6D APPLICATION: iaf 

YOUR PASSWORD WILL BE EXPIRED yy/mm/dd. 

JSN: ADDQ, NAMIAF 

READY. 

oLd,fortest 

READY. 

List 

10 PROGRAM TEST 
20 RE 

WELCOME TO THE NOS SOFTWARE SYSTEM. 
COPYRIGHT CONTROL DATA 1978, xxxx. 

yy/mm/dd. hh.mm.ss. T01A61 

CDC NETWORK OPERATING SYSTEM NOS 2 

FAMILY: systema 

USERNAME: jlc6021 

PASSWORD: jlc6 

T01A61 - APPLICATION: iaf 

YOUR PASSWORD WILL BE EXPIRED yy/mm/dd. 


The user logs in. 


The system assigns job sequence name 
ADDQ to the terminal session. 

The user retrieves saved file FORTEST 
and tries to list it. 


At this point, the terminal is 
disconnected. 


The user logs back in. 


JSN: ADDW, NAMIAF 
RECOVERABLE JOB(S) 


STATUS 


TIMEOUT 


ADDQ AIDQ SUSPENDED 29 MIN. 

ENTER GO TO CONTINUE CURRENT JOB, 

RELIST TO LIST RECOVERABLE JOBS, 

OR DESIRED JSN: addq 

JSN: ADDQ SYSTEM: FORTRAN SRU: 2.005 FILE NAME: 
STATUS: 

CHARACTER SET: NORMAL MODES: PROMPT ON 
IDLE. ENTER COMMAND. 


READY. 

List 

10 PROGRAM TEST 
20 READ *,I,J 
25 I=I*J 
30 PRINT *,I 
50 END 

READY. 


The system says that job ADDQ has 
been suspended and can be recovered, 
so the user enters that name. 


FORTEST 


At this point, job ADDQ is recovered 
and is in an idle state. All of the files 
and conditions of the job are the same 
as they were before the terminal 
became disconnected. 

The user lists the primary file. 
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Additional Information About the System 8 


The information in this manual is sufficient for you to enter programs and to correct them, run 
them, and save them. In addition, you’ve been introduced to some important system concepts, such 
as that of the primary file. 

It’s quite possible that the commands in this book are the only ones you will ever need to do your 
work. But if you find your needs increasing, or if you’re curious, we suggest you go on to NOS 2 
Reference Set, Volume 2, Guide to System Usage. Volume 2 explains more of the basic concepts of 
the system, for both interactive and batch users, and describes more system commands. 

NOS 2 Reference Set, Volume 3, System Commands, is the reference manual for all system 
commands discussed in this manual and in Volume 2. 

You may want to check with your employer, instructor, or computer center personnel for advice on 
which manual they would recommend and how you can get a manual. Ordering information is 
also provided in the preface. 
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A Glossary 

B Additional Information About Terminals 
C Using the Full Screen Editor 
D Using Full Screen Applications 





















Glossary 


A 


Acoustic Coupler 

A device in which you place a telephone receiver to connect a terminal to a telephone line. 
The telephone line is in turn connected to the system. After dialing the system, you place the 
telephone receiver in the rubber cups of the acoustic coupler, ensuring that the telephone-cord 
end of the receiver is at the correct end (marked on the coupler). An acoustic coupler is either 
built into the terminal (common on portable terminals) or a separate part (common on 
nonportable terminals). Contrast with Data Set. 

Alphanumeric Characters 

The letters of the alphabet (A through Z) and the digits (0 through 9). 

ASCII Mode 

Mode which uses the entire ASCII character set. ASCII stands for American Standard Code 
for Information Interchange. It is a code that can represent 128 characters, including 
uppercase and lowercase letters, numbers, and special characters. In ASCII mode, you can 
enter uppercase and lowercase letters and the system will not translate them all to uppercase 
as it does in normal mode. Contrast with Normal Mode. 


B_ 

BASIC 

Beginner's All-Purpose Symbolic Instruction Code. A high-level programming language used 
for fairly simple programs. 


C 


Cancel Line Sequence 

The character or sequence of characters that cancels the entry of the current line. When you 
type a line, the system does not accept it until you press the carriage return. If you enter the 
cancel line sequence before you press the carriage return, the line is ignored by the system. 
The sequence may differ on the terminal you're using, but usually you hold down the control 
key and press the X key. Then release both keys and press the carriage return. 

Catalog 

A collection of information about the permanent files associated with a particular user name. 
Every user who saves permanent files has a permanent file catalog. Each time you create, 
modify, or purge a permanent file, the system updates your catalog accordingly. You can list 
the names of your permanent files and other information about them using the CATLIST 
command. 
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Command 


An instruction you give to the system that causes it to perform an operation. 

Control Key 

A terminal key labeled CONTROL, CTRL, CNTL, CNTRL, or something similar. Many 
terminals require the control key to be pressed and held while another key is pressed for the 
cancel line sequence, interruption sequence, or termination sequence. 


D 


Data Set 

A device, similar in appearance to a normal telephone, that is used to connect a terminal to a 
telephone line. The telephone line is in turn connected to the system. After dialing the 
system, you either set the switch on the front of the data set to DATA or press the DATA 
button. You then replace the telephone receiver. The connection is made without placing the 
receiver in a separate device. Contrast with Acoustic Coupler. 

Default 

A value or name supplied by the system, if you do not supply it. For example, if you enter 
LIST without specifying a file name, the primary file (the default) is listed. 

Duplex 

Mode of transmission on a communication line. You need be concerned about duplex mode 
only to the extent of checking that the duplex switch on your terminal is set correctly for the 
line being used. Although the switch is normally set to HALF, personnel at your computer 
center can tell you the correct setting for your terminal. If you enter data but nothing is 
printed, check the duplex switch on your terminal; it is probably set incorrectly. 


E 


Execution 

The process of carrying out an instruction or a sequence of instructions (a program) by a 
computer. 


F 


Family Name 

Name of the permanent file storage device or set of devices on which all of your permanent 
files are stored. When you request a permanent file, the system looks for it on this family 
(group) of devices. Usually a system has only one family of permanent file devices, but it is 
possible to have alternate families in the system. You may have to specify which family you 
are using when you log in. Your family name is given to you by your employer, instructor, or 
computer center personnel. 
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File 


A collection of information referred to by a file name (from one through seven characters, 
either letters or numbers). You can create a file at the terminal or retrieve a file from 
permanent file storage for use during a terminal session. 

FORTRAN 

Formula Translation. A high-level programming language used for fairly complicated 
programs. 

Full Screen Application 

Any program that uses screen mode processing to display output information or to request 
user input of program data. 

FSE (Full Screen Editor) 

See Full Screen Editor. 

Full Screen Editor 

A text editor that gives you two methods of editing: line editing and screen editing. Line 
editing can be used on any kind of terminal and allows you to edit a line by typing a 
directive and specifying the appropriate line number. Screen editing can be used only on 
certain display terminals and allows you to move the cursor about freely on the screen and 
use special function keys on the keyboard to perform editing operations. 


H 


Hardwired Terminal 

A terminal that is always connected to the system. To begin a terminal session on a 
hardwired terminal, all you need to do is identify the terminal by pressing the proper key(s), 
and the login sequence begins (refer to Entering the System in section 3). 


I 


IAF (Interactive Facility) 

See Interactive Facility. 

Interactive Facility 

A program within NOS which provides a terminal operator with interactive (or 
conversational) processing capability. IAF is the application used in this manual. 

Indirect Access File 

The type of file described in this manual. When you access (retrieve) a file, you get a copy of 
the file and can make changes to the copy but not directly to the file. 
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Interruption Sequence 


The character or sequence of characters that interrupts a system operation (for example, 
listing a program or running a program). It may differ on the terminal you’re using, but 
usually you hold down the control key and press the P key. Then release both keys and press 
the carriage return. To resume the operation, you press the carriage return. 


J 


Job Sequence Name 

A four-character name assigned by the system to your terminal session. It is displayed at the 
end of the login procedure. If the system disconnects you before you are done with your work, 
you can log in again, and you may be able to resume your work by specifying the job 
sequence name assigned to your previous terminal session. 

JSN (Job Sequence Name) 

See Job Sequence Name. 


L 


Line/Local Switch 

Determines transmission of data. For normal operations, the switch should be set to the line 
position. When set to the local position, entries are printed at the terminal, but they are not 
transmitted to the system (even though the terminal is connected). This switch is also called 
the mode switch. 

Line Mode Processing 

A method of interactive usage in which program data or system commands are entered and 
executed on a line by line basis. Contrast with screen mode processing. 

Line Speed 

Rate of transmission of information between the terminal and the system measured in either 
characters per second or baud. (In general, the baud rate is 10 times the character-per-second 
rate.) Your computer center may restrict some terminals or phone lines to certain line speeds; 
ask personnel there what line speeds you can use. 

Local File 

A name used by the system to refer to a temporary file available at the terminal. 

Login 

Procedure during which you identify yourself to the system as an authorized user. To identify 
yourself, you enter certain responses to prompts from the system. These responses are given 
to you initially by your employer, instructor, or computer center personnel. They usually 
include a family name, user name, and password. 
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Logout 

Procedure by which you end a terminal session. You type BYE. 


M 


Mode Switch 

See Line/Local Switch. 


N 


Network 

A system of hardware and software that can be used to connect terminals to computers and 
computers to other computers. 

Nonprimary File 

A file that is available for use at the terminal but is not the primary file. Nonprimary files 
are often used to store the data needed to run a program or to store the data resulting from 
the execution of a program. Nonprimary files are not automatically rewound before a read or 
write operation. Contrast with Primary File. 

Normal Mode 

Mode in which the system translates any lowercase letters that you enter to uppercase 
letters. Contrast with ASCII Mode. 


P 


Parity 

Mode indicating a method of error detection. You need be concerned about parity mode only 
to the extent of checking that the parity switch on your terminal is set correctly. Personnel at 
your computer center can tell you the correct setting for your terminal. Parity is either even, 
odd, or disabled (not used). When used, a special bit (the parity bit) is set or cleared in the 
string of binary digits, so that the sum of the digits set, including the parity bit, is always 
even or always odd. When data is read, the sum is checked and, if it doesn't agree with the 
parity setting (even or odd), the system knows the data is incorrect. 

Password 

A name or word you enter during login to provide extra security for your user name. A 
unique password ensures that no one else can log into the system with your user name and 
access your files. Your password is given to you by your employer, instructor, or computer 
center personnel. 

Permanent File 

A file you create at the terminal and then save, so that you can retrieve it at a later terminal 
session. When you retrieve the file, the system makes a copy of the file for use at the 
terminal. The original file remains unchanged, even if you make changes to the copy at your 
terminal. If you want to save the changed copy of the file in place of the original file, you 
enter the REPLACE command. 
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Primary File 

The file on which operations are performed if no other file name is specified. You designate 
the primary file with the NEW, OLD, or PRIMARY command. The system automatically 
rewinds the primary file to its beginning before every operation performed on it. 

Program 

A sequence of instructions that are executed by a computer to perform a task. A program can 
be composed of several subprograms. 


PRU 


Physical record unit. It is a unit of size that is applied to files. 


R 


Run 


See Execution. 


S 


Screen Mode Processing 

A method of interactive usage in which formatted display screens are used to display output 
information or to request user input of program data. Contrast with line mode processing. 

SRU (System Resource Unit) 

See System Resource Unit. 

System 

Software and hardware that control the execution of computer programs and provide 
scheduling, error detection, input/output control, accounting, compilation, storage 
assignment, and related services. 

System Resource Unit 

A unit measuring system use that the system displays following certain operations and your 
logout. 


T 


Temporary File 

A file at the terminal that disappears when you either log out or enter the NEW or OLD 
command without /ND. You create a temporary file either by entering information in a 
primary file, retrieving a permanent file (thus making a temporary copy at your terminal), or 
as a result of program execution. 
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Terminal Session 


Period between the time you physically connect the terminal to the system in preparation for 
login to the time you log out. 

Termination Sequence 

The character or sequence of characters that terminates a system operation that is currently 
in progress (for example, listing a program or running a program). It may differ on the 
terminal you’re using, but usually you hold down the control key and press the T key. Then 
release both keys and press the carriage return. 

Text Mode 

Mode of entering information into a primary file without specifying line numbers. It is 
usually used to create data files. If a file does not contain line numbers, you can change lines 
only by using a text editor, such as Full Screen Editor. 


U 


User Name 

Name given to you by your employer, instructor, or computer center personnel. Your user 
name has certain resources and privileges assigned to it. When you log in, you specify your 
user name to identify yourself to the system, so that it knows that you are an authorized user 
and what resources you are entitled to use. Your user name also represents a specific catalog 
in the permanent file system. All files you make permanent are associated with your user 
name and this catalog. 
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This manual has assumed that you have a standard ASCII terminal that has auto-recognition 
defined for the line. To start the login process on that kind of terminal, you press the carriage 
return twice (described in section 3). To start the login procedure on any other kind of terminal, 
follow these procedures. 

• On standard ASCII terminals that have a fixed speed defined for the line, simply complete the 
connection from your terminal to the host. That is, if you use either an acoustic coupler or a 
data set, take the appropriate steps to dial into the system. If your terminal is directly wired to 
the host, simply turn your terminal on. 

• On mode 4A terminals, press the SEND key. (On these terminals, the SEND key takes the place 
of the carriage return.) 

• On mode 4C terminals, press ETX. (On these terminals, the ETX key takes the place of the 
carriage return.) 

• On all other terminals, press the carriage return. Wait until the system responds with two blank 
lines, then type a right parenthesis 

) 

followed by a carriage return. 
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c 


The Full Screen Editor has been designed to take advantage of the features found on certain 
display screen terminals. For example, the Full Screen Editor can fill a screen with lines of a file 
and allow you to edit anywhere on the screen by moving the cursor to a particular position. Then 
you can either type directly over existing characters or, by pressing a single key, perform an 
editing operation at that position. The Full Screen Editor also has directives that can be used on 
any terminal to edit line by line. 

The Full Screen Editor has two ways of editing: line editing and screen editing. Line editing allows 
you to edit on a line by line basis using line numbers. You type in a directive, specifying the line 
number you want to be affected by the directive. You can perform line editing on any terminal, 
whether it's a display terminal or a printing terminal. 

Screen editing allows you to edit by moving the cursor to a position within a displayed file and 
either entering the characters directly or pressing a key that performs the operation. You can 
perform screen editing on any of these display terminals: Control Data Corporation Viking 721, 
CDC 722, CDC 722-30, DEC VTl00,t Zenith Z19,t and Heathkit Hl9,t Lear Siegler ADM3A,t Lear 
Siegler ADM5,t Tektronix 4115,t and IBM 3270.t 

If you don’t have one of these terminals, you may still be able to use the screen editing feature. 
Through the use of a special software program described in the NOS Screen Formatting Reference 
Manual, it may be possible to make your display terminal operate in screen mode. Check with your 
site adminsitrator for more information. 

This appendix shows you how to edit a file using line editing and screen editing. Some of the line 
spacing shown in the terminal sessions is changed to allow easier reading of the comments. 

First we’ll show an example of line editing. You can always use the line editing directives 
regardless of the kind of terminal you’re using. 

Suppose the data file created in figure 5-5 

3 4 5 

2 1 5 

1-5197 1-5197 1.5197 
000 

had been entered like this instead. 

3 4 5 

1.5297 1.597 1.51987 
2 1 5 
0 0 0 


tDEC is a registered trademark of the Digital Equipment Corporation. Zenith Z19 is a product of the 
Zenith Corporation. Heathkit H19 is a product of the Heath Corporation. Lear Siegler ADM3A and 
Lear Siegler ADM5 are products of Lear Siegler Incorporated. Tektronix 4115 is a product of 
Tektronix Incorporated. IBM 3270 is a product of International Business Machines Corporation. 
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Follow this example to see what a few Full Screen Editor directives can do. 
Terminal Session Comments 


fse,data 
EDIT: DATA 

NOS FULL SCREEN EDITOR 


?? print all 
13 4 5 

2 1.5297 1.597 1.51987 

3 21 5 

4 0 0 0 


?? insert 1 


2 7 2 1 5 

3 ? 


?? print all 
13 4 5 

2 2 15 

3 1.5297 1.597 1.51987 

4 21 5 

5 0 0 0 

?? delete 4 
4 21 5 
?? print all 
13 4 5 

2 2 15 

3 1.5297 1.597 1.51987 

4 0 0 0 


This command starts the Full Screen 
Editor. If a file name is not included, the 
Full Screen Editor asks for the file name 
or, if the editor has already been used 
during this terminal session, it edits the 
same file. 

PRINT ALL displays the whole file. 
Notice that the Full Screen Editor has 
added line numbers that were not in the 
original file. They are used only by the 
Full Screen Editor and disappear when 
editing is through. 

The user wants to insert a new line after 
line 1. 

When prompted by a single question 
mark, the user enters the new line. 
Pressing the carriage return after the 
question mark tells the Full Screen 
Editor to stop inserting lines. 

Just to check, the user displays the file 
again. Notice that the subsequent line 
numbers have increased by one. 


The user deletes the fourth line. 
The user checks the file again. 
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Terminal Session 


Comments 


?? alter 3 

Next the user wants to alter line 3 which 
has several errors. 

3 1.5297 1.597 1.51987 

A?? 1 

3 1.5197 1.597 1.51987 

The Full Screen Editor displays the line 
to be changed. To replace a character, 
the user spaces over to it and types the 
new character. 

?? alter 3 

Now the user wants to alter line 3 by 
inserting a character. 

3 1.5197 1.5197 1.51987 

A?? "1 

3 1.5197 1.51197 1.51987 

To insert a character, the user spaces 
over to the position where the character 
should be, types A (the circumflex), and 
the new character. 

?? alter 3 

Finally the user wants to delete a 
character from line 3. 

3 1.5197 1.51197 1.51987 

A?? U 

3 1.5197 1.51197 1.5197 

To delete a character, the user spaces 
over to the character and types # (the 
number sign). 

?? p ri nt all 

13 4 5 

2 2 15 

3 1.5197 1.51197 1.5197 

4 0 0 0 

The user displays the entire file again 
and sees that it is correct. 

?? quit 

File: DATA (LOCAL) 

File: FSEPROC (NO CHANGES) 

QUIT stops the Full Screen Editor. 

READY. 

List,f=data 

3 4 5 

2 1 5 

1.5197 1.51197 1.5197 

0 0 0 

When the file is listed after editing, 
notice that the line numbers no longer 
appear. 

Remember, these changes are made only 
you must save or replace the file. 

on the copy of the file at your terminal. To keep them, 
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In summary, for line editing: 


Entry 


Description 


FSE,filename 
PRINT ALL 
INSERT number 
DELETE number 
ALTER number 

QUIT 


Starts editing on the file specified. 

Displays the entire file. 

Inserts following the line specified by number. 

Deletes the line specified by number. 

Alters the line specified by number. Characters can be replaced 
one-for-one, inserted (using * ), and deleted (using #). 

Ends editing on the file. 


Now we’ll show the same example using screen editing. Remember, you must have a display 
terminal that supports screen editing to perform screen editing. We’ll assume that a Viking 721 is 
used. 

First you must tell the system that you want to use screen mode rather than line mode which is the 
default. Type 

screen / 721 

When the system responds 


READY. 

type 

FSE,fi Lename 

In this case, the command that starts the Full Screen Editor is 
fse,data 

As in the earlier example, the file DATA 
3 4 5 

1.5297 1.597 1.51987 
21 5 
0 0 0 


will be changed to 


3 4 5 
2 1 5 

1 .5197 1.5197 1.5197 
0 0 0 
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After entering the FSE command, the following screen is displayed. 


NOS .FSki* StRZm EDiTOfc. 

£Ue &A.TA tines 1 thru 4 4 


?.5W 1*597 1.51$$? 
21 5 • 

OflO 


. MRKCHR .. ONECPY .. DELB l LAST . UNMARK !£ 111 LOCNXT 80C0L 

fi. MARK m MOVE |§ INSB f4- FIRST ||| UNDO F6 QUIT 1 | LOCATE §$: 132 COL 



To move the cursor while using screen editing, press one of the arrows on the 2, 4, 6, or 8 keys to 
the right of the main keyboard. 


On some terminals, like the CDC 722, you must press the shift key along with the arrow. 
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The rest of this example shows partial screens with comments to the right. 
T erminal Session Comments 


File DATA Lines 1 thru 4 Size 4 
3 4 5 

1.5297 1.597 1.51987 
21 5 
0 0 0 


The line under 3 represents the current 
position of the cursor. 


File DATA Lines 1 thru 4 Size 4 
3 4 5 

1.5297 1.597 1.51987 
21 5 

■ooo 


Pressing the down arrow (that is, the 
number 2 key) moves the cursor to the 
second line. 


File DATA Lines 1 thru 4 Size 4 
3 4 5 

T. 52 97 1.597 1.51987 
21 5 
0 0 0 


Pressing t he shift key (o) and the 
insert key (insrt) (on the upper 
righthand side of the keyboard) inserts a 
blank line where the cursor is positioned. 


File DATA Lines 1 thru 5 Size 5 
3 4 5 
2 1 5 

1.5297 1.597 1.51987 
21 5 
0 0 0 


The user can then type in the new line. 
When the carriage return is pressed, the 
line at the top is updated to show 5 lines. 


File DATA Lines 1 thru 5 Size 5 
3 4 5 
2 1 5 

1.5297 1.597 1.51987 
21 5 
0 0 0 


The cursor is positioned to the next line 
and the character to be edited, 2. 


File DATA Lines 1 thru 5 Size 5 

m 

2 1 5 

1.5197 1.597 1.51987 
21 5 
0 0 0 


The character in error is simply typed 
over and the correct character, 1, 
replaces it. 
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Terminal Session 


Comments 


File DATA Lines 1 thru 5 Size 5 
3 4 5 
2 1 5 

1.5197' 1.597 1.51987 
21 5 
0 0 0 


File DATA Lines 1 thru 5 Size 5 
3 4 5 
2 1 5 

1.5197 1 - 5_97 1.51987 
21 5 
0 0 0 


File DATA Lines 1 thru 5 Size 5 

m 

2 1 5 

1.5197 1.5197 1.51987 
21 5 
0 0 0 


File DATA Lines 1 thru 5 Size 5 
T~ZT~5 
2 1 5 

1.5197 1.5197 1.51987 
21 5 
0 0 0 


File DATA Lines 1 thru 5 Size 5 
3 4 5 
2 1 5 

1.5197 1.5197 1.5197 
21 5 
0 0 0 


File DATA Lines 1 thru 5 Size 5 
3 4 5 
2 1 5 

1.5197 1.5197 1.5197 
21 5 
0 0 0 


File DATA Lines 1 thru 5 Size 5 
3“4~5 
2 1 5 

1.5197 1.5197 1.5197 
0 0 0 


The cursor is again moved, this time to 
the position where a character should be 
inserted. 


Pressing th^ (insfit) key inserts a blank 
where the new character can be inserted. 


The new character is simply typed in. 


The cursor is moved to the 8, a character 
to be deleted. 


Pressing the (6 lete) key (on the upper 
righthand side of the keyboard) deletes 
the 8 and automatically moves the rest 
of the line over. 


The cursor is moved down to the fourth 
line. This line should be deleted. 


Pressin g the shift key (O) and the 
(dlete) key deletes the entire line. The 
file is now correct. 
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Pressing the function key labeled F6 at the top of the keyboard stops the Full Screen Editor. The 
system responds 

FILE: DATA 

FILE: FSEPROC (NO CHANGES) 

READY. 

Remember, the changes are made only on the copy of the file at your terminal. To keep them, you 
must save or replace the file. 

In summary, for screen editing: 

Entry _ Description __ 

Starts editing on the file specified. 

Moves the cursor in the direction indicated by the arrow (up, 
down, left, or right). The arrows are located on the numbers 2, 4, 
6, and 8 to the right of the main keyboard. 


Inserts a blank at the current position of the cursor. 


Inserts a blank line at the current position of the cursor. 


Deletes the character at the current position of the cursor. 


Deletes the line at the current positon of the cursor. 


FSE,filename 



(jNSRT) 


(3)(Tnsrt) 
(piete) 
(3)(dletD 


F6 function key 


Ends editing on the file. 


There are many more advanced features available on the Full Screen Editor. You can find out 
more by reading the Full Screen Editor user’s guide mentioned in the preface. 
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Interactive programs running on NOS can be used in either line or screen mode. Line mode 
processing requires the program to handle terminal input and output on a line by line basis. For 
each line of data which you enter, you must press the carriage return and wait for that line of data 
to be processed before you can continue. This is the sort of processing that you are probably 
already familar with, and, with the exception of the screen mode discussion in appendix C, is also 
the kind of processing that this manual has previously dealt with in its examples. 

Full screen processing, however, presents you with a full screen of information at once. You may 
then enter information in any order which you desire by moving the cursor to the appropriate 
position on the screen and typing your response.. Processing of the information begins only after 
all of the required information has been entered on the screen. Any program that allows you to use 
full screen processing is known as a full screen application. 

This section shows you how to use a full screen application. It informs you of some of the possible 
problems you might encounter when using a full screen application, and it tells you what to do 
should you encounter those problems. 

NOTE 


Before running a full screen application, you must use the SCREEN command described in 
appendix C of this manual. 


Terminals 

If you are having trouble running a full screen application, chances are the problems are caused 
by the terminal you are using. NOS supports a number of different terminals for use with full 
screen applications and allows many other terminals to be set up for use with them. Thus, there is 
a wide variety of terminals that you may encounter when you are using full screen applications. 

Of course, all of the terminals that can run a full screen application have certain minimal 
capabilities. However, all of these terminals do not necessarily have the same characteristics 
beyond those minimum capabilities. Differences can occur in what keys exist on a keyboard, how 
the keys are labeled, and in how the keys are arranged on the keyboard. Other differences occur in 
the terminal's hardware and software. The more sophisticated, or smarter, a terminal is, the easier 
it will be for you to run a full screen application. The less sophisticated, or dumber, a terminal is, 
the harder it will be to run a full screen application. 

In the sections that follow in this appendix, we will point out some of the more common problems 
users may have with terminals. Fortunately, none of the problems you might encounter will be 
insurmountable. In fact, the better acquainted you get with your terminal and its features, the 
fewer the problems you will have. But until you are well acquainted with your terminal, you may 
need to either consult your terminal's hardware reference manual or speak with someone who is 
already familiar with your terminal about its particular characteristics. 
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Entering Information to a Full Screen Application 

Information that a full screen application sends to your screen typically looks like information 
would on a sheet of paper. The information is presented to you one screen at a time, and any given 
application may have more than one screen of information to present to you. Figure D-l is an 
example of what a full screen application might look like on your screen. 



, To find the area of a triangle 


*7 ,: «&•••< ••• ^ • r• su \ . * 

MtytiFValues for Side A: 

Side 8: 

•• Side Ct 


Press: NEXT to execute 
F6 to quit 



Figure D-l. Sample Input Screen 


To enter information into the application, you must move the cursor to one of the input fields and 
type the information requested. In almost all full screen applications, an input field is designated by 
an underlined area (see figure D-l). However, in some full screen applications this may not 
necessarily be true. For instance, FSE is a full screen application, but the input fields are not 
underlined because the majority of the screen is an input field. In any case, when a screen load of 
information is first presented to you, the cursor is automatically placed at the beginning of the first 
input field. Simply type the requested information and then move to the next input field. 
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There are several different ways to move to the next input field. Usually the slowest way of 
moving from one input field to the next is to use the arrow keys, as described in Appendix C. This 
method, however, has the advantage of working the same way on all terminals which support full 
screen applications. 

The tab key will also move you to another input field. Each time you press the tab key your cursor 
will be moved one input field ahead without sending any information to the application for 
processing. However, if you pressed your tab key and the cursor is not moved ahead to the next 
input field, then you have a terminal that requires you to press the carriage return after the tab 
key. On these terminals, the cursor moves ahead one input field for each time you press the tab key 
before the carriage return. For example, if you are in the first input field, and you press the tab key 
twice and then the carriage return, then the cursor will be placed in the third input field on your 
screen. 

The final way to move to a different field is to use function keys. Application programmers set up 
function keys that perform certain tasks when you press them (see the section on function keys in 
this appendix). It is possible, though, that not all of the function keys on your keyboard have been 
defined for use with your application. If this is the case, then any undefined function keys on your 
keyboard work the same way that your tab key does. 

Once you have filled up the input fields on your screen with data, look at them to make sure the 
data is correct. If for any reason you wish to go back and change the data you have typed into an 
input field, you may do so by using the arrow, tab or function keys. To correct or change any of the 
data you have typed in, simply use the arrow, tab or function keys in the manner described 
previously to move to the appropriate input field. Once you are there, type the correct information 
over the old data. When you are using the tab or function keys, the first input field on your screen 
is the next field after the last input field on your screen. 

After you have correctly entered all of the required information requested on the screen, press the 
carriage return. Pressing the carriage return causes your terminal to send the information on the 
screen to the application for processing. The application will then either present the next screen of 
information to you, or display any necessary error messages. 


Error Messages 

Usually error messages are caused either by writing the wrong kind of data into an input field or 
by attempting to enter data when the cursor is in an area other than input field. If you attempt to 
input the wrong kind of data into an input field (for example, attempting to input a real number 
when an integer value is required), then an error message will appear in the first line of your 
screen, and the cursor will be placed at the beginning of the field where the incorrect data was 
entered. The error message should give you some idea of what kind of data the application is 
looking for in that field. To correct the field, type the correct data over the old data and press the 
carriage return. Make sure, however, that none of the original incorrect data is still visible on the 
screen before pressing the carriage return. In general, what you see in the input field is what is 
sent to the application for processing. Use the space bar to blank out any of the old data which is 
still visible in the input field. 
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If you attempt to enter data into areas on the screen other than the input fields, then several 
different things may happen depending on the terminal you are using. Some terminals, such as 
the Viking 721, will not allow you to enter data anywhere on the screen but in the input fields. 
Terminals of this type sustain protected fields. That is, the terminal knows where the input fields 
are and will not allow you to type outside of them. Other terminals, such as the CDC 722, do not 
sustain protected fields. On terminals such as these, what you type will overwrite anything that 
previously existed on that part of the screen. 

In either case, anything that is typed outside of the input field will not be sent to the application. 
Remember that an input field is any underlined area on your screen (see figure D-l). If part of your 
data exists inside and the rest exists outside of an input field, then the data is truncated to include 
only that part of the data which is inside of the input field. If any of your data exists outside of an 
input field, the message 

Please confirm 

will appear on the first line of your screen, the output fields where you attempted to type data will be 
repainted, and the cursor will be placed in the field where the data should have been entered. You 
must then either correct or accept any data existing in that field. 

Here are some other messages that you may see: 

PLEASE ENTER 
PLEASE CORRECT 
PLEASE PRESS FUNCTION KEY 
PLEASE REENTER INPUT 

The PLEASE ENTER is the default message that appears when you try to execute an application 
where you have not provided required information. The default message will not appear if the 
application writer has defined a help message for that parameter. 

PLEASE CORRECT is the default message if you have entered invalid data. 

PLEASE PRESS FUNCTION KEY means that the procedure has no input fields and that you 
should not try to input any data. Rather, press the function key that performs the function you wish 
to execute next. 

PLEASE REENTER INPUT can be caused by two things: one, if you have pressed a key or 
combination of keys that could not be recognized by the application, and two, if you have typed data 
before the application was ready to receive it. 


Common Problems 

One common problem that you may have is that you might not always understand what the 
application is asking you to input in a given field. This is usually because the information on the 
screen is too cryptic for a first time user of the application to understand. If you have this problem, 
then try pressing the help key when the cursor is in the field in question. Full screen application 
writers often build help routines into their applications. Otherwise, ask somebody who is familiar 
with the application to help you or simply experiment. Well written applications will allow you to 
recover gracefully from incorrect entries. 

Another problem you might have is that you may be prompted to reenter information even though 
the information already entered on your screen appears to be both correct and placed correctly in 
the input field. There are several reasons why this might happen. One is that for various reasons, 
NOS may not have received the information you tried to send. If this appears to be the problem, 
simply reenter the indicated data. 
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You may also be prompted to reenter data if the system has painted your screen wrong. Painting is 
the process the system uses to fill the screen with information. If you attempt to type anything 
before your screen has been completely painted, then you will cause your screen to look different 
than it actually should. Since full screen applications look for input from fixed areas on the screen 
regardless of what was actually painted there, a mispainted screen can cause problems when you 
attempt to enter data. If your screen has been painted wrong, then depending on the terminal you 
are using, type one of the following: 

shift erase and the carriage return 
or 

shift clear and the carriage return. 

This will cause your screen to be repainted without sending any information for processing. 


The Carriage Return and Other Function Keys 

Function keys are the keys on your keyboard marked FI, F2, F3, etc. or Pfl, Pf2, Pf3, etc. These 
keys allow NOS full screen application writers to define special, often complex functions which 
can be executed by pressing a single key. All terminals that support full screen applications have a 
mininum number of function keys. However, some terminals have more of these keys than others 
do, so NOS also allows almost any key or sequence of keys on the keyboard to be defined as a 
function key. Any function key which has not been defined for use with the application by the 
programmer acts as a tab key. 

When you are using a full screen application, any function keys that have been defined for your 
use should be labeled at the bottom of the screen. The cursor may be positioned anywhere on your 
screen when you use a function key; it does not have to be in an input field. Using a function key 
usually does not leave a mark on the screen. However, on some terminals such as the CDC 722, a 
character is always left on the screen after pressing a function key. This character does not affect 
any information it happens to overwrite, so it can be ignored. Repainting the screen causes the 
function key character to be deleted from the screen. 

The carriage return is also considered to be a function key. Pressing the carriage return usually 
causes the terminal to send information to the system for execution. However, application 
programmers are able to program a different function key other than the carriage return to 
perform this task. In either case, the proper key to press should be labeled in the bottom lines of 
your screen. 

After you have pressed the carriage return, there occasionally may be a pause before the system 
responds to your terminal again and sends the next screen of information for you to look at. If this 
happens, do not continue pressing the carriage return. In this situation, continually pressing the 
carriage return will only cause the system to send you the error message: 

Please reenter input. 

Generally you only want to press the carriage return when you wish to have information on the 
screen sent to the application for processing. However, terminals such as the CDC 722 also require 
you to press the carriage return after each use of a function key. If you are using a terminal like this, 
you also are required to press the carriage return after typing the help key. 
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If you are having trouble finding a particular function key on your keyboard, ask someone who is 
familar with your terminal to help you or consult your terminal’s hardware documentation. Since 
NOS allows you to define almost any key as a function key, finding a particular function key on your 
keyboard may not always be easy or obvious. In general, though, any given function key should be 
labeled on your keyboard exactly as indicated in the last few lines of your screen. 

NOTE 


For help on any questions involving function keys on the Full Screen Editor, refer to the NOS Full 
Screen Editor User’s Guide. 
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Reading data files 6-3 
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BYE 3-4 

CATLIST 5-12,19 
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OLD 4-6; 5-12 
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PURGE 5-20 
REPLACE 5-9 
RESEQ 4-4 
REWIND 5-2,14,19 
RUN 4-5 
SAVE 4-5; 5-9,16 
SCREEN C-4; D-l 
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Correcting a program/file 4-3; 5-16; C-l 
Examples 4-3; 5-17; C-l 
Creating a 
File 4-1; 5-3 
Primary file 5-3 
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Data files 6-1 

Data input to system 4-5; 6-1 
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DELETE command 4-3 
Delete lines 4-3 
Diagnostic messages 7-3 
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Disconnection from system 7-4 
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Information into a file 4-1; 5-5; C-l 


Revision D 


Introduction to Interactive Usage Index*l 




Entering the system 3-1 
Examples 3-2, 3 
Problems during 7-1 
Required information 1-2 
Entries, user 3; 1-1; 5-2 
Errors 7-1 
Examples 

ASCII mode 5-8 
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Entering a BASIC program 4-2 

Entering a FORTRAN program 4-2 

Entering a program 4-2 
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Replacing a program/file 5-11 
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Executing a program 4-5 
Definition (execution) A-2 

F 

Family name 1-3; 3-1 
Default 3-1 
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Writing data 6-1 
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Reading data files 6-1 
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FSE command C-2, 4 
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Error messages D-3 
Function keys D-3, 5 
Line and screen mode D-l 
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Terminals D-l 
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Examples C-2, 4 
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GET command 5-14 
Getting a saved program/file 
As a nonprimary file 5-14 
As a primary file 4-6; 5-12 
Glossary A-l 

H 

Hardwired terminal 2-2; A-3 
HELP command 4-8 
Help from the system 4-8 
How to 

Change the contents of a program/file 4-3; 

5-16; C-l 
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How to 
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5-16; C-l 

Change the primary file 5-3, 4,12 

Connect files to a program 6-1 

Connect your terminal to the system 2-1 

Correct a program/file 4-3; 5-16; C-l 

Create a primary file 5-3 

Create a program 4-1 

Edit a program/file 4-3; 5-16; C-l 
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Get help from the system 4-8 
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Log out 3-4 

Modify a program/file 4-3; 5-16; C-l 

Print a program/file 4-4; 5-14,19 

Purge a program/file 5-16 
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Remove a saved program/file 5-20 
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Use the manual 1-1 
Use the system 1-2 
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3; 7-2 
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Insert lines 4-3, 4; C-l 
Interrupting an operation 4-8 
Interruption sequence 4-7; A-4 


Job sequence name 7-4; A-4 
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Control 4-8; 5-6 
Function D-3, 5 
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Insertion 4-3, 4-4 
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LIST command 4-4; 5-14,19 
List of permanent files 5-12,19 
Listing a program/file 4-4; 5-14,19 
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Login 3-1; A-4 
Examples 3-1, 2 
Problems during 7-1 
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Logout 3-4; A-5 
Example 3-4 
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ASCII versus normal mode 5-7 
Conventions in examples 1-1 
Conversion by the system 5-7 
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Mode switch A-5 
Mode 4A terminals B-l 
Mode 4C terminals B-l 
Modifying a program/file 4-3; 5-16; C-l 
MULTIPLE CONCURRENT LOGFIVS 
PROHIBITED Message 7-2 
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/ND 5-3,12 

NEW command 4-1; 5-3 
No drop 5-3,12 
Nonprimary files 

Changing the contents of 5-16; C-l 
Description 5-1, 2; A-4 
Replacing 5-9 
Retrieving 5-14 
Saving 5-9 

NORMAL command 5-7 
Normal mode 5-7; A-5 
NOT FOUND message 5-12 
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OLD command 4-6; 5-12 
OPEN statement 6-1 
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Parity switch 7-1; A-5 
Password 1-3; 3-2; A-5 
Permanent files 5-1; A-5 

Changing the contents of 5-16; C-l 
Creating 4-5; 5-9,16 
List of 5-12,19 
Retrieving 5-12,14 
Personal ID 1-3; 3-1, 2 
Positioning nonprimary files 5-2,14,19 
PRIMARY command 5-4 
Primary file 
Changing 5-4 

Changing the contents of 4-3; 5-16; C-l 

Creating 4-1; 5-3 

Description 5-1, 2; A-6 

Entering information into 5-5 

Example 5-3, 4 

Replacing 5-9 

Retrieving 5-12 

Saving 5-9 

Printing a program/file 4-4; 5-14,19 
Problems/suggestions 7-1 
Connecting to system 7-1 
Disconnection from the system 7-4 
During a terminal session 7-3 
During login 7-1 
During program execution 7-4 
Listing a file 5-14 
Setting up terminal 7-1 
Program 

BASIC example 4-2 

Changing the contents of 4-3; 5-16; C-l 

Connecting files to 6-1 

Correcting 4-3; 5-16; C-l 


Creating 4-1 

Definition A-5 

Editing 4-3; 5-16; C-l 

Entering 4-1 

Executing 4-5 

FORTRAN example 4-2 

Getting a saved program 4-6; 5-12,14 
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Interrupting 4-8 

Language 4-1 

Line numbers 4-1 

Linking files to 6-1 

Listing 4-4; 5-14, 19 

Modifying 4-3; 5-16; C-l 

Printing 4-4; 5-14,19 

Purging 5-20 

Putting on the system 4-1 
Reading data files 6-1 
Removing 5-20 
Replacing 5-9 
Resequencing 4-4 

Retrieving a saved program 4-6; 5-12,14 
Running 4-5 
Saving 4-5; 5-9,16 
Stopping 4-8 
Writing data files 6-1 
PRU 5-19; A-6 
PURGE command 5-20 
Purging a saved program/file 5-20 
Putting a program on the system 4-1 
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Question mark printed by the system 4-5 
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Reading data files 
BASIC 6-3 
FORTRAN 6-1 
Recoverable jobs 7-4 
Recovering a terminal session 7-4 
Removing a saved program/file 5-20 
REPLACE command 5-9 
Replacing a program/file 5-9 
Example 5-11 

Required information 1-2, 3 
RESEQ command 4-4 
Resequencing line numbers 4-4 
Resuming a terminal session 7-4 
Retrieving a saved program/file 
As a nonprimary file 5-14 
As a primary file 4-6; 5-12 
REWIND command 5-2,14,19 
Rewinding files 5-2,14, 19 
RUN command 4-5 
Running a program 4-5 


Index-4 Introduction to Interactive Usage 


Revision E 



s 

SAVE command 4*5; 5-8,14 
Saving a program/file 4-5; 5-9,16 
Example 5-4,17 
SCREEN command C-4 
Screen editing C-l, 4 
Session, terminal 3-1; 7-3; A-6 
Setting terminal switches 2-1; 7-1 
SRU 4-5; A-6 
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Switches, terminal 2-1; 7-1 
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Telephone numbers 1-2 


T 

TALK switch/button 2-2 
Telephone numbers to the system 1-2 
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Terminals 
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Problems 7-1, 2 
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TEXT command 5-5 
Text editor 5-6 
Text mode 5-5; A-7 
Example 5-6, 8 
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TIMEOUT message 7-2 
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ASCII versus normal mode 5-7 
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Conversion by the system 5-7 
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BASIC 6-3 
FORTRAN 6-1 
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NOS 2 Reference Set Volume 1 
Introduction to Interactive Usage 

We would like your comments on this manual. While writing it, we made some assumptions about 
who would use it and how it would be used. Your comments will help us improve this manual. 
Please take a few minutes to reply. 


How Do You 

Who Are You?_ Use This Manual?_Do You Also Have? 


□ Manager 

□ Systems Analyst or 
Programmer 

□ Applications 
Programmer 

□ Operator 

□ Other 


□ 

As an Overview 

□ 

To Learn the 


Product/System 

□ 

For Comprehensive 


Reference 

□ 

For Quick Look-up 


□ Volume 2, Guide to 
System Usage 

□ Volume 3, System 
Commands 

□ NOS Full Screen 
Editor User’s Guide 


What programming languages do you use?- 

Which are helpful to you? □ Index on inside cover □ Full Screen Editor (Appendix C) 

□ Glossary □ Other:- 


How Do You Like This Manual? Check those that apply. 


Yes 

Somewhat 

No 


□ 

□ 

□ 

Is the manual easy to read (print size, page layout, and so on)? 

□ 

□ 

□ 

Is it easy to understand? 

□ 

□ 

□ 

Is the order of topics logical? 

□ 

□ 

□ 

Are there enough examples? 

□ 

□ 

□ 

Are the examples helpful? (□ Too simple □ Too complex) 

□ 

□ 

□ 

Does the manual tell you what you need to know about the topic? 

□ 

□ 

□ 

Is there enough information about terminals? 

□ 

□ 

□ 

Are our assumptions about the login procedure on your system 
correct? (If not, please comment below.) 


Comments? If applicable, note page number and paragraph. 


Would you like a reply? □ Yes □ No Continue on other side 

From: 

Name_ Company- 

Address_ Date- 

_ Phone No- 


Please send program listing and output if applicable to your comment. 


BUSINESS REPLY MAIL 

FIRST CLASS PERMIT NO. 8?41 MINNEAPOLIS, MINN. 

POSTAGE WILL BE PAID BY 

CONTROL DATA CORPORATION 

Publications and Graphics Division 
ARH219 

4201 North Lexington Avenue 
Saint Paul, Minnesota 55126-6198 











